OA(包括微信、钉钉、飞书、WeLink)
当插件日志出现 error 级别的日志的时候(非代码 Exception,例如 npe,没办法给出建议),给用户提供一个错误码和一个url,引导用户到解决方案页面查询错误原因。
插件错误码说明如下:
sb 参数是插件用来判断是哪个应用正在单点登录的,缺少sb参数则会导致单点登录失败,请检查单点登录链接中有没有带上sb参数,如果是自行构造的链接,则需要把fine_weixin_agent表中 id 列拼上"weixin"再经过 md5 编码得到 sb 参数
钉钉、飞书、WeLink同理
微信用户如果处于被禁用状态,会导致单点登录失败,请去微信解除用户的禁用状态。钉钉、飞书、WeLink同理
确认匹配关系设置是否正确
可参考对应文档:微信管理插件4.3 成员管理;钉钉管理插件2.10 成员管理
如果日志中报出connection refused字样的错误,说明当前服务器网络是无法与外网建立连接的。
可以通过“curl https://qyapi.weixin.qq.com/cgi-bin/gettoken”来验证,如果有返回内容,则说明外网可以连通,如果没有返回内容,则说明外网无法连通。
如果日志中报出UnKnownHostException: qyapi.weixin.qq.com,则说明当前服务器所在网络的 dns 解析服务器无法解析微信的域名地址。
如果需要使用 nginx 代理转发的方式才可以访问外网,请参考文档:代理服务器配置,最后将设置好的代理地址填入「微信管理>快捷配置」中。
如果当前服务器所在网络使用的是系统代理,则需要在 web 容器中指定 jvm 参数:-Dhttp.proxyHost=代理地址 -Dhttp.proxyPort=端口。
最后说明一点:如果微信插件报网络异常的错误,则可以通过邮件通知来测试是不是真的是服务器无法访问外网导致的
微信测试地址: https://qyapi.weixin.qq.com/cgi-bin/gettoken
钉钉测试地址:https://oapi.dingtalk.com/gettoken
飞书测试地址:https://open.feishu.cn/open-apis/auth/v3/app_access_token/internal/
WeLink测试地址:https://open.welink.huaweicloud.com/api/auth/v2/tickets
微信:
在确保服务器网络可以连通外网的前提下,
1)请检查当前应用里面是否有 secret 或者 corpid 填写错误的应用。
2)请检查无法获取 token 的应用是否已经在微信管理后台被删除了。
3)请确保 fine_weixin_agent 表中不存在管理组秘钥的应用(即 type 字段为 1 的应用)
钉钉:
在确保服务器网络可以连通外网的前提下,请检查当前应用里面是否有 secret 或者 appKey 填写错误的应用
钉钉插件错误码说明如下:
滑鼠選中內容,快速回饋問題
滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。
不再提示
10s後關閉
反馈已提交
网络繁忙