行動端整合問題排查手冊

針對微信、釘釘、飛書、WeLink整合遇到的問題，提供排查手冊幫助使用者快速定位和解決這些問題。使用者也可參考以下文檔尋找解決方案。

相關文檔連結：

行動端功能常見問題：行動端功能常見問題

釘釘整合常見問題：釘釘整合常見問題及解決方案

微信整合常見問題：微信整合常見問題及解決方案

OA 錯誤碼對照表：OA錯誤碼對照表

遇到行動端整合相關問題時，可以先按照以下流程圖進行排查，如下圖所示：

除錯功能請參考：行動端整合除錯工具

如果按照流程排查仍未解決問題，可以按照具體問題以及功能點進行排查和解決，下面表格中列出一些問題及解決方案。

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）將圖片重新上傳試試