OA錯誤碼對照表

1. 概述

OA(包括微信、釘釘、飛書、WeLink)

當插件日誌出現 error 級別的日誌的時候(非程式碼 Exception,例如 npe,沒辦法給出建議),給使用者提供一個錯誤碼和一個url,引導使用者到解決方案頁面查詢錯誤原因。

2. 錯誤碼對照表

2.1 通用

插件錯誤碼說明如下:

錯誤碼
錯誤說明排查方法
21001單點登入 url 中 sb 參數缺失

sb 參數是插件用來判斷是哪個應用正在單點登入的,缺少sb參數則會導致單點登入失敗,請檢查單點登入連結中有沒有帶上sb參數,如果是自行構造的連結,則需要把fine_weixin_agent表中 id 列拼上"weixin"再經過 md5 編碼得到 sb 參數

釘釘、飛書、WeLink同理

21002OA使用者被禁用了

微信使用者如果處於被禁用狀態,會導致單點登入失敗,請去微信解除使用者的禁用狀態。釘釘、飛書、WeLink同理

21003獲取OA使用者詳細資訊失敗網路異常,請參考 23001 的排查方案
21004獲取OA使用者 userid 失敗網路異常,請參考 23001 的排查方案
21005決策平台中使用者不存在單點登入中,OA使用者匹配到的平台使用者不存在,請檢查是否在平台中建立了使用者
21006手機號碼匹配模式下,OA使用者沒有設定手機號碼導致單點登入失敗請檢查OA使用者是否設定了手機號碼
21007決策平台使用者被禁用了請去決策平台的使用者管理中解除禁用狀態
21008手機號碼匹配模式下,決策平台使用者沒有設定手機號碼導致單點登入失敗請檢查決策平台使用者是否設定了手機號碼
21009手動匹配失敗請檢查fine_weixin_user_releation表中是否存在單點登入使用者的匹配關係。釘釘、飛書、WeLink同理
21010資料集匹配失敗請檢查資料集中是否存在單點登入使用者的匹配關係
21011沒有找到資料集,單點登入失敗請檢查資料集是否可用
21012單點登入匹配失敗

確認匹配關係設定是否正確

可參考對應文檔:微信整合4.3 成員管理;釘釘整合2.10 成員管理

22001推播的應用缺失檢查一下fine_weixin_agent表中需要推播的應用是不是已經被刪除了,如果被刪除了,請重建立立一個應用。釘釘、飛書、WeLink同理
22002未知的訊息類型如果是從 8.0 升級上來的排程管理,則資料庫中可能會有未知推播類型的訊息,在 9.0 以及 10.0 中這些訊息被預設當成連結訊息推播
22003呼叫微信上傳檔案API失敗可能是API呼叫超頻,此時查看日誌中微信傳回的資訊是否提示超頻了。如果有報錯,則參考網路異常 23001 的排查方案
22004推播的圖片附件沒能找到檢查WEB-INF/assets/temp_attach下面是否有排程管理中上傳的圖片。如果沒有的話,需要重新編輯排程管理上傳一次圖片
22005讀取檔案失敗推播檔案訊息的時候,請覈查WEB-INF/schedule/${taskname}/${data}/${time}/${username}下是否存在排程管理生成的結果附件
23001網路異常
  • 微信釘釘飛書專案部署代理伺服器時,可能會有網路異常問題。微信釘釘可以參考文檔解決異常:FineReport外網地址 3.1節

  • 如果日誌中報出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

23002無法獲取 token

微信:

在確定伺服器網路可以連通外網的前提下,

1)請檢查當前應用裏面是否有 secret 或者 corpid 填寫錯誤的應用。

2)請檢查無法獲取 token 的應用是否已經在微信管理後台被刪除了。

3)請確定fine_weixin_agent表中不存在管理組祕鑰的應用(即 type 欄位為 1 的應用)

釘釘:

在確定伺服器網路可以連通外網的前提下,請檢查當前應用裏面是否有 secret 或者 appKey 填寫錯誤的應用

24001生成手機號碼匹配關係的時候,平台使用者為空手機號碼匹配關係是手機號碼匹配推播必須的,請檢查平台使用者是否為空

2.2 微信特有

錯誤碼
錯誤說明排查方法
30001應用類型不正確請檢查當前同步的應用中是否存在管理組金鑰應用( 2018 年之前建立的微信老應用)
30002獲取部門列表失敗請檢查應用中是否設定了可見部門,如果設定了,請參考網路異常 23001 的排查方案
30003獲取標籤列表失敗請檢查應用中是否設定了可見標籤,如果設定了,請參考網路異常 23001 的排查方案
30004獲取可見標籤失敗請檢查應用中是否設定了可見標籤
30005獲取部門詳細資訊失敗請參考網路異常23001的排查方案
30006獲取部門成員失敗請參考網路異常23001的排查方案
30007生成手機號碼匹配關係的時候,平台使用者為空手機號碼匹配關係是手機號碼匹配推播必須的,請檢查平台使用者是否為空
30008獲取標籤成員失敗請參考網路異常23001的排查方案


2.3 釘釘特有

釘釘插件錯誤碼說明如下:

錯誤碼
錯誤說明排查方法
43001當前應用中沒有可見範圍的應用如果釘釘的應用可見範圍勾選了部分可見,則需要手動指定好可見部門才可以在釘釘插件成員管理中進行同步
43002獲取可見範圍內的部門資訊失敗網路異常,請參考 23001 的排查方案
43003獲取部門的詳細資訊失敗網路異常,請參考 23001 的排查方案
43004獲取部門的子部門列表失敗網路異常,請參考 23001 的排查方案
43005獲取部門成員列表失敗網路異常,請參考 23001 的排查方案

2.4 飛書特有

錯誤碼錯誤說明排查方式
50001生成手機號碼匹配關係的時候,平台使用者為空手機號碼匹配關係是手機號碼匹配推播必須的,請檢查平台使用者是否為空
50002獲取部門列表失敗請檢查應用中是否設定了可見部門,如果設定了,請參考網路異常 23001 的排查方案
50003獲取部門成員失敗網路異常,請參考 23001 的排查方案

2.5 WeLink特有

錯誤碼
錯誤說明排查方式
60001生成手機號碼匹配關係的時候,平台使用者為空手機號碼匹配關係是手機號碼匹配推播必須的,請檢查平台使用者是否為空
60002獲取部門列表失敗請檢查應用中是否設定了可見部門,如果設定了,請參考網路異常 23001 的排查方案
60003獲取部門成員失敗網路異常,請參考 23001 的排查方案



附件列表


主題: 行動端應用
已經是第一篇
已經是最後一篇
  • 有幫助
  • 沒幫助
  • 只是瀏覽
中文(繁體)

滑鼠選中內容,快速回饋問題

滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

不再提示

8s后關閉

獲取幫助
線上支援
獲取專業技術支援,快速幫助您解決問題
工作日9:00-12:00,13:30-17:30在线
頁面反饋
針對當前網頁的建議、問題反饋
售前咨詢
業務咨詢
電話:0933-790886或 0989-092892
郵箱:taiwan@fanruan.com
頁面反饋
*問題分類
不能為空
問題描述
0/1000
不能為空

反馈已提交

网络繁忙

反饋已提交

網絡繁忙