移动端集成调试工具

1.1 版本

1.2 应用场景

解决移动端集成过程中遇到的各种问题，大大提高工作效率。如：网络不通没法访问微信服务、同步不到通讯录、推送收不到消息等等。

1.3 功能简介

提供微信/钉钉/飞书/WeLink 调试工具，在「管理系统>微信/钉钉/飞书/WeLink管理>调试工具」中，可下载日志，并进行集成功能调试。如下图所示：

1.4 注意事项

• V11.0.68 之前版本：飞书和 Welink 没有调试工具；微信和钉钉可以通过「访问链接」的方式，进入调试界面。

• V11.0.68 及之后版本：飞书和 Welink 在管理界面的「调试工具」访问；

  访问微信钉钉旧调试入口会重定向至「微信管理/钉钉管理」页面，切换到「调试工具」即可使用。
  

由于移动端集成的「调试工具」相同，本文以钉钉管理插件为例。

1）选择要下载的日志级别，完成后点击「保存」。完成后重启工程，否则可能不生效。

2）复现集成的问题步骤，完成后选择下载日志的时机范围，点击「一键下载」即可生成「logs.zip」解压获得日志文件。如下图所示：

不同日志级别对应的报错日志可参考：日志简介

注：如果日志文件大于1G，暂不支持下载，建议缩小日期范围后重试。

3）分析日志

打开日志后，就能查看到操作失败的原因，错误码和对应帮助文档。如下图所示：

3.1 检测请求耗时

检测作用：有些访问比较慢的客户场景，可以用检测工具查看一下再客户环境上的请求耗时，用来判断是否是网络影响了实际使用。调试内容选择「检测请求耗时」并点击「开始检测」。如下图所示：

3.2 基本属性

3.2.1 操作步骤

检测点：查看用户信息获取情况。

作用：确认参数，网络，对应微信应用配置是否正确。

• token：若 token 没有获取到，大概率是网络异常，用户环境可能无法访问钉钉服务器，需要排查网络情况。

• IP白名单：若管理后台没有配置 IP白名单 ，则应用添加不成功。

操作步骤：选择「基本属性」和检测的企业应用名称，点击「开始检测」后，正常配置下现象如下图所示：

微信正常配置如下图所示：

3.2.2 检测异常

异常现象 1 ：若token没有获取到，会给出对应报错提示

可能的原因 1 ：网络异常，用户环境可能无法访问微信服务器。解决方案：需要排查网络情况；

可能的原因 2 ：使用的微信参数不正确，包括但不限于：① id 和 secret 不匹配；② 对应的 secret 被重置导致原来的 secret 不能用；③ 对应 secret 应用被删/被停用了。

异常现象 2 ：若获取的部门用户列表是空

可能是原因 1 ：是对应应用没有设置可见范围；

可能是原因 2 ：可见范围设置的是单个用户（正常应该选择部门或者标签），但我们目前不支持可见范围只选择用户来获取用户信息。

异常现象 3： ip 不在白名单中

相关场景：钉钉应用添加的时候会校验白名单 IP ，若钉钉管理后台没有配置这个 IP ，则应用添加不成功，但是应该填写具体什么IP，往往这个出口 IP 不知道怎么获取。

使用这个功能可以在用户添加钉钉应用之前先检查一下白名单配置，若 IP 不在白名单内，则检测结果中会把对应的 IP 打印出来，这样直接把这个 IP 复制到钉钉后台应用那边即可正常添加。

3.3 推送消息

3.3.1 操作步骤

切换调试内容为「推送消息」，输入推送用户名，完成点击「开始检测」，正常情况下调试页面如下：

注：推送用户写已同步到平台内的用户姓名。

每检测一次，都会由应用发送一条测试消息，如下图所示：

3.3.2 检测异常

若收不到测试消息，可能是应用那边的问题，比如手机没有开启消息接收，后台有请求拦截等。

3.4 权限检测

只有 钉钉/飞书管理 插件有这项检测。

对于应用开的权限进行检测。「权限检测」输入「企业应用名称」点击「开始检测」。如果企业应用正常如下图所示：

如果监察处权限缺失，需要开启对应权限。

3.5 单点登录

切换调试内容为「单点登录」，多出「微信用户」和「主页/菜单链接」两个参数，输入相应的信息，点击「开始检测」，显示出检测结果信息： Token、报表用户信息。正常情况下调试页面如下图所示：

注 1 ：微信用户写同步到平台内的微信成员名，在「成员管理>微信通讯录」可查看。

注 2 ：主页/菜单链接填写的是移动端集成插件>应用快捷配置中生成的单点链接。

3.5.1 检测作用

查看用户的匹配是否正确，用户单点链接是否正确。

3.5.2 检测异常

若调试结果不对，则需要检查参数填写是否有问题，匹配是否没有配置好，或者url生成的不对，可信域名配置不正确等，具体参照企业微信集成配置的文档。