在我们集成 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 -