反馈已提交

网络繁忙

移动端集成调试工具

  • 文档创建者:jiangsr
  • 历史版本:17
  • 最近更新:April陶 于 2023-07-26
  • 1. 概述

    1.1 版本

    微信/钉钉/飞书/WeLink管理插件版本功能变动
    V11.0.68-

    1.2 应用场景

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

    1.3 功能简介

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

    2022-06-28_19-34-23.jpg

    1.4 注意事项

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

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

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

    集成插件访问链接
    微信管理在平台地址后加上/url/weixin/start/debugger
    钉钉管理在平台地址后加上/url/dingtalk/start/debugger

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

    2. 分析日志

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

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

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

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

    2022-06-28_19-46-41.jpg

    3)分析日志

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

    2022-06-28_20-45-36.jpg

    3. 集成功能调试

    3.1 检测请求耗时

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

    2022-06-28_21-06-25.jpg

    3.2 基本属性

    3.2.1 操作步骤

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

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

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

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

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

    2022-06-28_21-08-12.jpg

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

    1656422810564039.jpg

    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 操作步骤

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

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

    2022-06-28_21-14-03.jpg

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

    2022-06-28_21-16-54.jpg

    3.3.2 检测异常

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

    3.4 权限检测

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

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

    2022-06-28_21-19-57.jpg

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

    3.5 单点登录

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

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

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

    2022-06-29_10-24-26.jpg

    3.5.1 检测作用

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

    3.5.2 检测异常

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


    附件列表


    主题: 移动端应用
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持