“运行环境加载失败（2,101）”，微信小程序打不开，怎么办？

Question

提示截图如下：

1.情况描述：对小程序进行抓包测试，在手机的wifi设置了手动代理。
2.结果：微信的小程序都打不开，提示“运行环境加载失败（2,101）”。
3.解决办法尝试：关闭手动代理，微信小程序可恢复正常，可以正常打开。
4.问题：关闭了手动代理，没办法进行抓包测试了，使用的抓包工具是Fiddler。
网友们，你们遇到这个情况，有没有解决办法？

Answer 1

下午好🌅🌅🌅
本答案参考通义千问

你遇到的问题是 “运行环境加载失败（2,101）”，这在微信小程序中是一个较为常见的错误，通常与网络环境、代理设置或安全机制有关。根据你的描述，问题出现在你设置了 手动代理（如 Fiddler） 时，导致小程序无法正常加载。

---

✅ 一、问题分析

1. 错误代码说明

• “运行环境加载失败（2,101）”：这是微信小程序框架的错误提示，表示小程序的运行环境未能成功加载。
• 常见原因包括：
  • 网络环境异常（如代理设置不正确）
  • SSL/TLS 证书问题
  • 小程序包未正确加载
  • 微信客户端安全机制拦截了某些网络请求

2. 抓包工具影响

• 你使用的是 Fiddler，它通过 HTTP 代理 来捕获和修改网络请求。
• 当你开启代理后，微信小程序可能因安全策略或网络配置问题无法正常连接到服务器或加载资源。

---

✅ 二、解决方案

1. 解决方法一：使用 HTTPS 代理 + 自定义证书

✅ 原因

• 微信小程序对 HTTPS 请求有严格的校验机制，若代理未使用 HTTPS 或证书不被信任，会触发安全拦截。

✅ 步骤如下：

1. 在 Fiddler 中启用 HTTPS 捕获

   • 打开 Fiddler → Tools → Options → HTTPS
   • 勾选："Decrypt HTTPS traffic"
   • 安装 Fiddler 的根证书（如果提示安装）

2. 将手机的代理设置为 Fiddler 的 HTTPS 地址

   • 例如：192.168.x.x:8888

3. 在手机上信任 Fiddler 的证书

   • 进入手机设置 → 无线网络 → 选择当前 WiFi → 修改 DNS 和代理
   • 设置代理为 Fiddler 的 IP 和端口（如 192.168.x.x:8888）
   • 在浏览器访问 https://fiddler:8888 下载并安装证书

4. 重新打开微信小程序进行测试

⚠️ 注意：确保所有请求都是 HTTPS 协议，否则仍可能触发错误。

---

2. 解决方法二：使用 Android Debug Bridge (ADB) 抓包（适用于安卓设备）

✅ 原因

• ADB 是官方支持的调试工具，不会被微信安全机制拦截。

✅ 步骤如下：

1. 连接手机到电脑

   • 使用 USB 数据线连接手机和电脑
   • 开启手机的 开发者选项 和 USB 调试

2. 使用 ADB 抓包工具

   • 推荐工具：mitmproxy 或 Charles Proxy（支持 ADB 代理）

3. 配置 ADB 代理

   • 在终端执行：

     adb shell setprop http.proxyHost 192.168.x.x
     adb shell setprop http.proxyPort 8888
     

   • 重启微信小程序

✅ 这种方式更稳定，且不会触发微信的安全机制。

---

3. 解决方法三：临时关闭微信安全机制（仅限测试环境）

✅ 原因

• 微信小程序默认会对非标准网络环境进行安全限制。

✅ 步骤如下：

1. 在微信开发者工具中开启“不校验合法域名”

   • 打开微信开发者工具
   • 项目设置 → 项目配置 → 不校验合法域名、HTTPS 证书等

2. 在真机调试中开启“不校验安全域”

   • 在微信开发者工具中，点击“详情” → “项目配置” → 勾选“不校验安全域”

⚠️ 该方式仅适用于测试阶段，正式发布时需恢复校验。

---

4. 解决方法四：使用虚拟机或模拟器进行抓包

✅ 原因

• 有些抓包工具在真机上容易被微信识别为异常行为。

✅ 步骤如下：

1. 使用 Android Studio 的模拟器

   • 安装 Android Studio
   • 创建一个虚拟设备（AVD）
   • 在模拟器中安装微信小程序，并设置代理

2. 使用 Charles Proxy 或 mitmproxy 抓包

   • 在模拟器中设置代理为 PC 的 IP 和端口

---

✅ 三、推荐方案总结（按优先级排序）

| 方案 | 优点 | 缺点 | |------|------|------| | ✅ 方法一：HTTPS 代理 + 证书 | 保留代理功能，不影响微信运行 | 需要安装证书，操作稍复杂 | | ✅ 方法二：ADB 抓包 | 稳定、安全、不受微信限制 | 只适用于安卓设备 | | ✅ 方法三：关闭安全校验 | 快速有效 | 仅限测试环境 | | ❌ 方法四：虚拟机/模拟器 | 安全性高 | 依赖开发环境 |

---

✅ 四、代码示例（可选）

如果你需要在小程序中 动态设置代理（如用于测试），可以尝试以下方式（注意：此方式可能被微信屏蔽）：

// 小程序中无法直接设置系统代理，但可以通过自定义请求实现
wx.request({
  url: 'https://your-api.com',
  method: 'GET',
  header: {
    'content-type': 'application/json'
  },
  success(res) {
    console.log('请求成功', res.data);
  },
  fail(err) {
    console.error('请求失败', err);
  }
});

⚠️ 微信小程序不允许通过 JS 直接设置全局代理，建议使用上述方法结合 Fiddler 或 ADB 抓包。

---

✅ 五、最终建议

推荐你使用 ADB 抓包（方法二），因为这是最稳定、最符合微信安全策略的方式，同时又能满足你抓包的需求。

---

如果你还有其他相关问题（如抓包过程中出现 SSL 错误、无法解析数据等），欢迎继续提问！