1. 概述编辑
针对微信、钉钉、飞书、WeLink集成遇到的问题，提供排查手册帮助用户快速定位和解决这些问题。
2. 问题排查流程编辑
3. 具体问题排查编辑
如果按照流程排查仍未解决问题，可以按照具体问题进行排查和解决，下面表格中列出一些具体问题及解决方案。
| 功能场景 | 功能点 | 问题现象 | 解决方案 |
|---|---|---|---|
| 应用管理 | 服务器地址 | 部署访问报错无法加载 | 服务器地址不能以 / 结尾，主要是会影响生成链接拼接参数和定时调度推送链接的生成 可修改单点链接或平台访问地址规避这个问题，服务器地址要以/decision结尾，不能只写http(s)://域名:端口 |
| 通讯录 | 同步 | 飞书同步不到用户 | 飞书应用目前只支持可见范围是全体成员，如果选择单个部门，飞书管理的用户管理处无法获取到飞书用户 移动端插件 11.0.65 版本之后支持可见范围是部门，可以更新插件解决该问题 |
| 其他配置 | 插件注册 | 插件过期后更换 lic 仍显示未注册 | 1）确认插件是否是二开定制插件 2）多个环境进行测试，确认 lic 是否异常（帆软市场异常会导致当时申请的 lic 功能异常） |
| 同步用户 | 平台报错同步失败，失败原因：树构建失败，XX部门找不到对应父部门 | 1）创建的微信应用，可见范围只是根部门下的某个部门，修改应用的可见范围为根部门或使用 tag 标签（tag标签只能够选单个用户，如果勾选了部门是无法同步的） 2）企业微信私有部署，不想设置可见范围是根部门，也不支持根据 tag 标签修改应用可见范围，可联系帆软技术支持通过二次开发处理 | |
| 成员管理 | 点击成员管理报错500 | 检查 plugins 下是否有多个版本的集成插件，关闭工程删掉多余的插件，保证工程重启后 plugins 下只有要用的版本即可 | |
| 单点 | 登录失败 | 显示移动端的登录页面 | 1）微信管理后台自建应用的应用主页填写的不是单点链接 单点链接的生成参考 4.2.3 节：企业微信集成 2）所有用户都显示登录页面 平台用户和集成用户都正常添加可查看，可能是匹配方式错误，参考文档 4.3 节 企业微信集成 平台用户或集成用户里没有用户数据，平台用户没有数据添加，集成用户没有数据可参考上方“通讯录-同步” 3）部分用户显示登录页面 该用户在平台被禁用 平台用户或集成用户的数据缺失导致匹配失败，例如匹配方式为手机号匹配，微信钉钉通讯录里有手机号123，但是平台用户表里没有手机号123。需要保持两边数据一致 4）查看日志 weixin.log 等集成插件的日志 日志中查看，单点登录时间节点的日志记录，查看单点登录的报错，按照报错提示解决 |
| 显示PC的登录页面 | 安装HTML5移动端展示插件后，按照上边的方案进行处理 | ||
| 用户有自己的门户登录页，登录门户账号后会跳转到平台登录页而不是直接访问首页/目录/单张模板 | 用户自己写了门户登录页，却没有放行微信请求，可以抓包定位到问题并且放行 /weixin/single/login请求 钉钉、飞书、WeLink同理：/dingtalk/single/login /feishu/single/login /welink/single/login | ||