簡介：?讓天下沒有打不開的小程序！！！

在我們集成 mPaaS 插件并使用小程序的過程中，很多開發(fā)者遇到了打不開小程序的問題。今天就舉例說明，開發(fā)者在完成基本接入后，嘗試打開 H5 應(yīng)用，但容器頁面顯示錯誤提示“設(shè)置標(biāo)簽”時，應(yīng)該如何解決。

?

常見原因

mPaaS 框架在打開一個H5應(yīng)用前，首先需要獲知該應(yīng)用離線包的基本信息。

因此客戶端會主動通過RPC接口alipay.client.getUnionResource去拉取離線包信息。如果離線包信息獲取失敗，或沒有命中要打開的目標(biāo)應(yīng)用，容器會提示錯誤 “系統(tǒng)繁忙，請稍后再試”。

針對這類問題，排查方向包括：檢查 RPC 請求是否正常、檢查環(huán)境和離線包發(fā)布是否匹配等。

問題排查步驟

（一）檢查 RPC 請求是否正常

客戶端需要主動拉取離線包信息，而拉取過程依賴 RPC 請求，如果RPC 鏈路存在問題，則無法正常獲取離線包信息，導(dǎo)致加載失敗。要確認(rèn) 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 請求的簽名驗(yàn)證過程有關(guān)，常見錯誤代碼及原因如下：

錯誤碼說明示例

7000	沒有設(shè)置公鑰	移動 APP 中無線保鏢中無 appId 對應(yīng)的密鑰或者網(wǎng)關(guān)無法獲取 appId 對應(yīng)的簽名密鑰。
7001	驗(yàn)簽的參數(shù)不夠	網(wǎng)關(guān)服務(wù)端驗(yàn)證簽名不通過。
7002	驗(yàn)簽失敗	網(wǎng)關(guān)服務(wù)端驗(yàn)證簽名不通過。
7003	驗(yàn)簽-時效性失敗	API 請求入?yún)?ts 時間戳超過系統(tǒng)設(shè)置的時間有效性。需要檢查客戶端時間是否為系統(tǒng)時間。
7007	驗(yàn)簽-缺少 ts 參數(shù)	API 請求缺少驗(yàn)簽 ts 參數(shù)。
7014	驗(yàn)簽-缺少 sign 參數(shù)	API 請求缺少驗(yàn)簽 sign 參數(shù)。一般情況下是客戶端簽名數(shù)據(jù)失敗，導(dǎo)致缺失 sign 參數(shù)。請檢查客戶端無線保鏢圖片是否正確。

（二）基本排查動作

1. 檢查 mPaaS 控制臺設(shè)置的 Bundle ID 與 iOS 工程是否完全一致，包括：

mPaaS 控制臺（控制臺 > 代碼配置 > iOS）上設(shè)置的 Bundle ID：

?

工程的 Bundle "Indentifier：

?

工程中 Info.plist 的 Bundle Indentifier:

?

2. 控制臺下載的 .config 文件內(nèi)容與項(xiàng)目中的 meta.config 是否完全一致：

mPaaS 控制臺下載的 .config 文件：

?

工程中的 meta.config 文件：

?

3. 客戶端設(shè)備的時間是否為當(dāng)前時間，時間誤差必須小于 8 小時。

4. 如果上述檢查存在信息不一致，則檢查不通過，建議：

• 修改工程中的信息，確保與 mPaaS 控制臺一致。
• 如果手機(jī)時間信息不正確，請修正時間配置。
• 從控制臺下載最新 .config文件，通過mPaaS Extension 插件重新導(dǎo)入：

?

• 確認(rèn)所有信息正確后，卸載已安裝的 App，重新打包編譯后進(jìn)行調(diào)試，觀察 RPC 7XXX 類錯誤是否得到解決。

（三）檢查 H5 App 信息和發(fā)布狀態(tài)是否正確

客戶端需要主動拉取離線包信息，在 RPC 請求正常返回的前提下，如果服務(wù)端沒有返回目標(biāo)離線包的信息，也會導(dǎo)致加載失敗的錯誤，錯誤原因?yàn)殡x線包 AppNotExist 不存在。

基本檢查動作：

1.根據(jù)檢查RPC請求是否正常的說明，確認(rèn)alipay.client.getUnionResource
RPC請求是否可以正常返回。

2.在 Xcode 控制臺搜索錯誤關(guān)鍵字 AppNotExist，確認(rèn)問題根因是否為找不到目標(biāo) H5 App，例如：

?

3.在 mPaaS 控制臺和 iOS 工程中交叉確認(rèn)如下信息，包括：

• worksapceId、appId、mpaasapi 等元數(shù)據(jù)：控制臺和 meta.config 中的相關(guān)配置要完全一致，如果不一致，需要重新下載 .config 文件并導(dǎo)入。
• 目標(biāo)離線包 ID：離線包管理頁中的離線包 ID 要和工程代碼中要打開的離線包 ID 一致；
• 查看離線包發(fā)布狀態(tài)，確認(rèn)離線包是否存在一個處于發(fā)布狀態(tài)的版本：

?

• 查看離線包發(fā)布狀態(tài)，確認(rèn)離線包資源類型：必須為“普通資源包”；“全局資源包”不可直接打開；
• 查看離線包發(fā)布狀態(tài)，確認(rèn)該發(fā)布的離線包版本：必須 大于 客戶端已安裝的離線包版本；
• 查看離線包發(fā)布狀態(tài)，確認(rèn)該發(fā)布覆蓋的客戶端版本范圍：必須覆蓋測試 App 的當(dāng)前版本號；注意：iOS 項(xiàng)目中，客戶端版本號依賴info.plist 中的 Produc Version 字段，而不是 Xcode 項(xiàng)目 version，這里需要開發(fā)者手動同步。

?

?

工單協(xié)助

如果依然不能解決問題，請準(zhǔn)備好相關(guān)問題的復(fù)現(xiàn) Demo 工程，通過阿里云工單系統(tǒng)聯(lián)系 mPaaS 售后技術(shù)支持。

?

原文鏈接
本文為阿里云原創(chuàng)內(nèi)容，未經(jīng)允許不得轉(zhuǎn)載。

總結(jié)

以上是生活随笔為你收集整理的排查指南 | 关于 mPaaS-iOS 小程序打不开问题的解决方案的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。