簡介: 讓天下沒有打不開的小程序!!!
在我們集成 mPaaS 插件並使用小程序的過程中,很多開發者遇到了打不開小程序的問題。今天就舉例說明,開發者在完成基本接入後,嘗試打開 H5 應用,但容器頁面顯示錯誤提示“設置標籤”時,應該如何解決。
常見原因
mPaaS 框架在打開一個H5應用前,首先需要獲知該應用離線包的基本信息。
因此客戶端會主動通過RPC接口alipay.client.getUnionResource去拉取離線包信息。如果離線包信息獲取失敗,或沒有命中要打開的目標應用,容器會提示錯誤 “系統繁忙,請稍後再試”。
針對這類問題,排查方向包括:檢查 RPC 請求是否正常、檢查環境和離線包發佈是否匹配等。
問題排查步驟
(一)檢查 RPC 請求是否正常
客戶端需要主動拉取離線包信息,而拉取過程依賴 RPC 請求,如果RPC 鏈路存在問題,則無法正常獲取離線包信息,導致加載失敗。要確認 RPC 請求是否存在問題,需要在 Xcode 控制檯中搜索 alipay.client.getUnionResource 觀察 RPC 請求是否正常返回。如果存在錯誤,一般的錯誤代碼包括 7XXX 或 3XXX 系列等,例如:
正常返回樣例(result-status 爲 1000):
Demo[83767:2555863] [mPaaSLog] APMobileNetwork alipay.client.getUnionResource resp:{
"Content-Encoding" = gzip;
"Content-Type" = "text/plain;charset=UTF-8";
Date = "Tue, 11 Aug 2020 05:01:37 GMT";
Vary = "Accept-Encoding";
"mgw-traceid" = 0a1cfd401597122097726853822435;
"result-status" = 1000;
"server-time" = 1597122097739;
}
錯誤返回樣例(result-status 不爲 1000):
Demo[83383:2546279] [mPaaSLog] APMobileNetwork alipay.client.getUnionResource resp:{
"Content-Length" = 0;
"Content-Type" = "text/plain;charset=UTF-8";
Date = "Tue, 11 Aug 2020 04:50:08 GMT";
memo = "%E9%AA%8C%E7%AD%BERPC%E6%8E%A5%E5%8F%A3%20%E5%8A%A0%E7%AD%BE%E6%95%B0%E6%8D%AE%E4%B8%BA%E7%A9%BA";
"mgw-traceid" = 0a1d7667159712140890222728553;
"result-status" = 7014;
"server-time" = 1597121408902;
tips = "%E9%AA%8C%E7%AD%BERPC%E6%8E%A5%E5%8F%A3%20%E5%8A%A0%E7%AD%BE%E6%95%B0%E6%8D%AE%E4%B8%BA%E7%A9%BA";
}
RPC 7XXX 系列錯誤的處理方法
7XXX 類錯誤均與 RPC 請求的簽名驗證過程有關,常見錯誤代碼及原因如下:
錯誤碼 | 說明 | 示例 |
---|---|---|
7000 | 沒有設置公鑰 | 移動 APP 中無線保鏢中無 appId 對應的密鑰或者網關無法獲取 appId 對應的簽名密鑰。 |
7001 | 驗籤的參數不夠 | 網關服務端驗證簽名不通過。 |
7002 | 驗籤失敗 | 網關服務端驗證簽名不通過。 |
7003 | 驗籤-時效性失敗 | API 請求入參 ts 時間戳超過系統設置的時間有效性。需要檢查客戶端時間是否爲系統時間。 |
7007 | 驗籤-缺少 ts 參數 | API 請求缺少驗籤 ts 參數。 |
7014 | 驗籤-缺少 sign 參數 | API 請求缺少驗籤 sign 參數。一般情況下是客戶端簽名數據失敗,導致缺失 sign 參數。請檢查客戶端無線保鏢圖片是否正確。 |
(二)基本排查動作
1. 檢查 mPaaS 控制檯設置的 Bundle ID 與 iOS 工程是否完全一致,包括:
mPaaS 控制檯(控制檯 > 代碼配置 > iOS)上設置的 Bundle ID:
工程的 Bundle "Indentifier:
工程中 Info.plist 的 Bundle Indentifier:
2. 控制檯下載的 .config 文件內容與項目中的 meta.config 是否完全一致:
mPaaS 控制檯下載的 .config 文件:
工程中的 meta.config 文件:
3. 客戶端設備的時間是否爲當前時間,時間誤差必須小於 8 小時。
4. 如果上述檢查存在信息不一致,則檢查不通過,建議:
- 修改工程中的信息,確保與 mPaaS 控制檯一致。
- 如果手機時間信息不正確,請修正時間配置。
- 從控制檯下載最新 .config文件,通過mPaaS Extension 插件重新導入:
- 確認所有信息正確後,卸載已安裝的 App,重新打包編譯後進行調試,觀察 RPC 7XXX 類錯誤是否得到解決。
(三)檢查 H5 App 信息和發佈狀態是否正確
客戶端需要主動拉取離線包信息,在 RPC 請求正常返回的前提下,如果服務端沒有返回目標離線包的信息,也會導致加載失敗的錯誤,錯誤原因爲離線包 AppNotExist 不存在。
基本檢查動作:
1.根據檢查RPC請求是否正常的說明,確認alipay.client.getUnionResource
RPC請求是否可以正常返回。
2.在 Xcode 控制檯搜索錯誤關鍵字 AppNotExist,確認問題根因是否爲找不到目標 H5 App,例如:
3.在 mPaaS 控制檯和 iOS 工程中交叉確認如下信息,包括:
- worksapceId、appId、mpaasapi 等元數據:控制檯和 meta.config 中的相關配置要完全一致,如果不一致,需要重新下載 .config 文件並導入。
- 目標離線包 ID:離線包管理頁中的離線包 ID 要和工程代碼中要打開的離線包 ID 一致;
- 查看離線包發佈狀態,確認離線包是否存在一個處於發佈狀態的版本:
- 查看離線包發佈狀態,確認離線包資源類型:必須爲“普通資源包”;“全局資源包”不可直接打開;
- 查看離線包發佈狀態,確認該發佈的離線包版本:必須 大於 客戶端已安裝的離線包版本;
- 查看離線包發佈狀態,確認該發佈覆蓋的客戶端版本範圍:必須覆蓋測試 App 的當前版本號;注意:iOS 項目中,客戶端版本號依賴info.plist 中的 Produc Version 字段,而不是 Xcode 項目 version,這裏需要開發者手動同步。
工單協助
如果依然不能解決問題,請準備好相關問題的復現 Demo 工程,通過阿里雲工單系統聯繫 mPaaS 售後技術支持。
原文鏈接
本文爲阿里雲原創內容,未經允許不得轉載。