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）将图片重新上传试试
上一篇：部署App自定义发布平台
