在我們整合 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 請求的簽名驗證過程有關，常見錯誤程式碼及原因如下：

（二）基本排查動作

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 售後技術支援。

下期預告

mPaaS 小程式啟動一直 Loading 該如何排查？

撰文：滕巨集才

- END -