微信小程序授权 API 调试中缓存问题总结

📌 问题背景

在开发微信小程序过程中，一些需要用户授权的 API（如 wx.getLocation、wx.getUserProfile、wx.authorize 等）在 微信开发者工具的模拟器 中调试时，其授权状态（同意或拒绝）会被模拟器缓存。

然而实际测试中发现，这种缓存状态在某些场景下竟然会影响真机上的 API 调用表现，表现为：

• 真机上授权弹窗不再弹出；
• 明明未授权却返回已授权状态；
• 授权状态异常但没有错误提示。

🎯 典型现象

• 在模拟器中反复测试某个授权接口（比如模拟拒绝或允许）；
• 使用开发者工具扫码进行真机调试或预览；
• 真机表现异常，如调用授权接口无反应或跳过了应有的授权流程；
• 清除微信开发者工具的缓存后，真机表现恢复正常。

🧠 原因分析

• 微信开发者工具的模拟器会缓存授权状态；
• 在使用“扫码调试”或“预览”功能时，开发者工具可能会同步部分状态到真机（如登录态、storage、授权信息）；
• 真机在调试时会读取这些同步信息，导致行为不符合预期。

✅ 建议解决方案

1. 尽量避免依赖模拟器测试授权行为，改用真机调试。
2. 在调试授权流程时：
   • 清除微信开发者工具缓存（设置 → 清除缓存 / 清除模拟登录态）；
   • 在微信真机中删除小程序 → 重新扫码进入，确保干净状态。
3. 使用更稳健的逻辑处理授权状态：
   • 使用 wx.getSetting() 获取用户当前授权状态；
   • 对于敏感接口，使用 wx.openSetting() 引导用户手动授权；
   • 避免单次授权判断流程控制整个逻辑，应设计兜底逻辑。

🔍 示例代码建议

wx.getSetting({
  success(res) {
    if (!res.authSetting['scope.userLocation']) {
      // 未授权，引导授权
      wx.authorize({
        scope: 'scope.userLocation',
        success() {
          // 用户同意授权
        },
        fail() {
          // 用户拒绝授权，引导手动打开设置页
          wx.showModal({
            title: '授权提示',
            content: '需要开启定位权限才能使用该功能',
            success(modalRes) {
              if (modalRes.confirm) {
                wx.openSetting();
              }
            }
          });
        }
      });
    } else {
      // 已授权
    }
  }
});