1. 概述
OA(包括微信、釘釘、飛書、WeLink)
當插件日誌出現 error 級別的日誌的時候(非程式碼 Exception,例如 npe,沒辦法給出建議),給使用者提供一個錯誤碼和一個url,引導使用者到解決方案頁面查詢錯誤原因。
2. 錯誤碼對照表
2.1 通用
插件錯誤碼說明如下:
錯誤碼 | 錯誤說明 | 排查方法 |
---|---|---|
21001 | 單點登入 url 中 sb 參數缺失 | sb 參數是插件用來判斷是哪個應用正在單點登入的,缺少sb參數則會導致單點登入失敗,請檢查單點登入連結中有沒有帶上sb參數,如果是自行構造的連結,則需要把fine_weixin_agent表中 id 列拼上"weixin"再經過 md5 編碼得到 sb 參數 釘釘、飛書、WeLink同理 |
21002 | OA使用者被禁用了 | 微信使用者如果處於被禁用狀態,會導致單點登入失敗,請去微信解除使用者的禁用狀態。釘釘、飛書、WeLink同理 |
21003 | 獲取OA使用者詳細資訊失敗 | 網路異常,請參考 23001 的排查方案 |
21004 | 獲取OA使用者 userid 失敗 | 網路異常,請參考 23001 的排查方案 |
21005 | 決策平台中使用者不存在 | 單點登入中,OA使用者匹配到的平台使用者不存在,請檢查是否在平台中建立了使用者 |
21006 | 手機號碼匹配模式下,OA使用者沒有設定手機號碼導致單點登入失敗 | 請檢查OA使用者是否設定了手機號碼 |
21007 | 決策平台使用者被禁用了 | 請去決策平台的使用者管理中解除禁用狀態 |
21008 | 手機號碼匹配模式下,決策平台使用者沒有設定手機號碼導致單點登入失敗 | 請檢查決策平台使用者是否設定了手機號碼 |
21009 | 手動匹配失敗 | 請檢查fine_weixin_user_releation表中是否存在單點登入使用者的匹配關係。釘釘、飛書、WeLink同理 |
21010 | 資料集匹配失敗 | 請檢查資料集中是否存在單點登入使用者的匹配關係 |
21011 | 沒有找到資料集,單點登入失敗 | 請檢查資料集是否可用 |
21012 | 單點登入匹配失敗 | 確認匹配關係設定是否正確 |
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 | 網路異常 |
微信測試地址: 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 的排查方案 |