1. 概述
针对微信、钉钉、飞书、WeLink集成遇到的问题,提供排查手册帮助用户快速定位和解决这些问题。用户也可参考以下文档查找解决方案。
相关文档链接:
移动端功能常见问题:移动端功能常见问题及解决方案
钉钉集成常见问题:钉钉集成常见问题及解决方案
微信集成常见问题:微信集成常见问题及解决方案
OA 错误码对照表:OA错误码对照表
2. 排查思路
遇到移动端集成相关问题时,可以先按照以下流程图进行排查,如下图所示:
调试功能请参考:移动端集成调试工具
3. 功能点逐一排查
如果按照流程排查仍未解决问题,可以按照具体问题以及功能点进行排查和解决,下面表格中列出一些问题及解决方案。
3.1 应用管理-服务器地址
问题描述:
部署访问报错无法加载。
解决方案:
服务器地址不能以 / 结尾,主要是会影响生成链接拼接参数和定时调度推送链接的生成
可修改单点链接或平台访问地址规避这个问题,服务器地址要以/decision结尾,不能只写http(s)://域名:端口
3.2 通讯录-同步
问题描述:
同步不到用户。
解决方案:
可参考:钉钉集成常见问题、微信集成常见问题、微信钉钉推送/单点/同步失败日志定位
3.3 插件注册
问题描述:
插件过期后更换 lic 仍显示未注册
解决方案:
1)确认插件是否是二开定制插件
2)多个环境进行测试,确认 lic 是否异常(帆软市场异常会导致当时申请的 lic 功能异常)
3.4 成员管理
问题描述:
点击成员管理报错 500。
解决方案:
检查 plugins 下是否有多个版本的集成插件,关闭工程删掉多余的插件,保证工程重启后 plugins 下只有要用的版本即可
3.5 单独登录失败
解决方案:
可参考:单点登录失败排查步骤
3.6 单点后报错
解决方案:
3.7 推送失败
解决方案:
1)同步 JAR 包
2)可参考:钉钉集成常见问题
3)Oracle 锁表导致平台定时调度执行异常问题:定时调度快照生成成功,偶尔几个用户的邮件发送失败,用户不确定、用户数量不确定
修改$ORACLE_HOME/network/admin/sqlnet.ora,添加或者修改成sqlnet.expire_time=0,即关闭 Oracle 的连接状态检测;修改数据连接的连接池属性,最大等待时间设置为50000毫秒;修改定时任务超过时间,ScheduleSettingConfig.taskTimeout再当前值的基础上再加3分钟,即480000毫秒
3.8 消息接收
3.8.1 用户收不到消息
解决方案:
1)重新手动同步下用户是否解决
2)用户是否匹配了平台用户
3)用户匹配的平台用户是否在推送的范围内
3.8.2 定时任务部分用户收不到消息
解决方案:
3.8.3 某一个用户收不到消息
解决方案:
1)是否为多企业用户,若用户添加两个企业,则更新插件至11.0.62,对应版本处理过多企业同名用户匹配的问题。
2)在同步通讯录中是否能找到对应用户
3)用户是否匹配了平台用户
4)用户匹配的平台用户是否在推送的范围内
3.9 消息内容
3.9.1 推送的消息内容字数限制
解决方案:
微信钉钉 API 的一些限制
参考:https://developer.work.weixin.qq.com/document/path/90236
文本消息:消息内容,最长不超过 2048 个字节,超过将截断
图文消息:标题,不超过 128 个字节,描述,不超过 512 个字节
3.9.2 提示找不到模板文件
解决方案:
1)检查webroot/WEB-INF/schedule/任务名/时间/对应文件夹下,是否有文件生成
2,确认是否有两个环境配置了同一个应用,不支持两个工程配置同一个微信/钉钉/飞书/WeLink应用,会相互排挤的,除非是集群的两个子节点
3)确认是否是集群环境,是的话是否两个节点间的数据没有同步,导致打开模板访问的是未同步数据的节点
3.9.3 显示内容有问题
解决方案:
定时结果在 H5 下显示问题,更新下新自适应插件。
3.9.4 推送出来的消息,用户权限错乱
排查步骤:
检查是否在推送的时间点,有其他同步,ETL取数等事件在同步处理,影响到了
3.10 参数生效
问题描述:
生成单点的模板链接,设置参数不生效 now(),fine_username。
排查步骤:
定时调度,设置参数=fine_username不生效,可能导致文件控件无法使用。
3.11 图文推送
3.11.1 图文推送的图片封面偶发不显示
排查步骤:
1)确认是否是集群环境
2)集群环境下,见下集群各个节点是否正常,状态服务器文件服务器是否配置,文件缓存是否开启
3.11.2 图文推送图片收不到
排查步骤:
1)检查任务是否配置了图片
2)将图片重新上传试试