排查指南 | 當 mPaaS 小程序真機掃碼時提示「應用更新錯誤（50002）」

問題描述

APP 掃碼 mPaas 小程序彈出 toast 信息："應用更新錯誤（50002）"。

 

緣由分析

經過掃碼進行真機調試的正常流程以下：

1. 在小程序 IDE 生成二維碼，以供手機客戶端掃描，同時會將小程序包上傳至 mPaaS 控制檯的小程序發佈中。
2. 手機客戶端掃描此二維碼後，會主動經過 RPC 請求去拉取控制檯中的 AMR 文件。

 

當調用 MDS 小程序更新接口後，若沒有獲取對應的小程序信息，就會提示「應用更新錯誤（50002）」。這類問題可能的緣由包括：

• 服務端還沒有發佈，包括：
  • 控制檯未發佈上傳的小程序。
  • 小程序剛發佈，但服務端還沒有收到剛發佈的小程序。
• 客戶端版本不在範圍內。
• 請求信息和服務端發佈的規則不匹配。

 

排查思路

1. 過濾日誌

在 Android Studio 控制檯的日誌信息中過濾關鍵字 DynamicRelease。查看 UnionResourceInfo 中是否有 Item 信息。

• 正常狀況下，會含有 item 信息，示例以下：
  

•  若未包含 item 信息，則爲異常，示例以下：

 

2. 檢查接入真機預覽和調試功能

按照Android 小程序接入真機預覽與調試中的步驟檢查檢查接入真機預覽和調試是否正確。

 

3. 檢查客戶端版本範圍

版本號對應 Android 項目 versionName 值。只有當最低版本號 < 當前 App 版本號 < 最高版本號時，才能正常的拉取小程序。若不在這個範圍，App 啓動小程序時就會拉取失敗，報 "應用更新錯誤"。

因此推薦在最低版本輸入 0.0.0.0，最高版本不填寫（表示無限大）。

注意事項

因爲在小程序 IDE 上傳、預覽、真機調試會自動將小程序上傳至控制檯，無需用戶在控制檯修改配置信息，因此在建立小程序時，不推薦從小程序發佈中添加小程序包，防止出現主路徑不一致。如要修改小程序，能夠在小程序 IDE 中修改。

 

4. 檢查主入口路徑

查看 mPaaS 控制檯中填寫的小程序主入口路徑是否與小程序 IDE 中的主入口路徑一致。

mPaaS控制檯默認主路徑格式爲：/index.html#xxx/xxx/xxx/xxx，其中 # 後方的 xxx/xxx/xxx/xxx 是小程序的 app.json 中的 pages 中的第一個值。

 

工單協助

若是依然不能解決問題，請準備好相關問題的復現 Demo 工程，經過阿里雲工單系統聯繫 mPaaS 售後技術支持。

 

 

撰文：劉啓洋

 

- END -