getUserInfo:fail 未获取用户授权如何处理？

Question

在微信小程序开发中，调用 `wx.getUserInfo` 时频繁出现 `getUserInfo:fail` 错误，主要原因为用户未授权或使用了已废弃的接口方式。由于微信官方自2021年起逐步废弃 `wx.getUserInfo` 的主动弹窗授权机制，开发者若未及时迁移到 `button + open-type="getUserInfo"` 或新版 `requestAuthorization` 方式，将无法获取用户信息并触发失败回调。此外，用户首次拒绝授权后，未引导其手动开启权限，也会导致持续授权失败。如何正确迁移至新授权机制，并优雅处理用户拒绝授权的场景，成为实际开发中的常见难题。

Answer 1

1. 问题背景与历史演进

微信小程序自2016年发布以来，用户授权体系经历了多次重大调整。早期开发者可通过调用 wx.getUserInfo 接口直接获取用户公开信息（如昵称、头像），该接口会主动弹出授权窗口，用户体验简单直接。

然而，出于隐私保护和数据安全考虑，微信官方于2021年起逐步废弃 wx.getUserInfo 的静默调用机制，并明确要求开发者迁移至基于按钮触发的授权方式。此举旨在提升用户对个人信息使用的知情权与控制权。

若继续使用旧接口，在用户未预先授权的情况下，将频繁出现如下错误：

getUserInfo:fail the api need to be declared in the scope of getuserinfo

或

getUserInfo:fail user deny

这标志着原有“主动拉取”模式已不可持续，必须进行架构级重构。

下表对比了新旧授权方式的核心差异：

维度	旧方式 (wx.getUserInfo)	新方式 (button + open-type)
调用时机	代码中任意位置调用	需用户点击按钮触发
授权弹窗	自动弹出（已被限制）	仅在 button 点击时弹出
用户控制	弱，易被滥用	强，显式操作
兼容性	低版本支持，高版本受限	推荐方案，长期支持
scope 配置	无需声明	需在 app.json 中配置 scope.userInfo

2. 技术迁移路径详解

1. 检查当前项目是否仍在使用 wx.getUserInfo 进行非按钮触发的信息获取。
2. 在 app.json 或页面配置中添加权限声明：
   

   {
     "permission": {
       "scope.userInfo": {
         "desc": "用于展示您的昵称和头像"
       }
     }
   }

3. 替换原逻辑为通过 WXML 中的 button 组件触发授权：

<button open-type="getUserInfo" bind:getuserinfo="onGetUserInfo">
  获取用户信息
</button>

对应的 JS 处理函数应如下实现：

onGetUserInfo(e) {
  if (e.detail.errMsg === 'getUserInfo:ok') {
    const userInfo = e.detail.userInfo;
    this.processUserInfo(userInfo);
  } else {
    console.warn('用户拒绝授权', e.detail.errMsg);
    this.handleAuthReject();
  }
}

注意：从基础库 2.10.4 开始，微信引入了更细粒度的 wx.requestAuthorization 接口，可用于统一管理多种权限请求，是未来推荐方向。

3. 用户拒绝授权的优雅处理策略

当用户首次拒绝授权后，再次调用将不会重新弹窗，导致信息无法获取。此时需结合以下流程图引导用户手动开启权限：

graph TD A[尝试获取用户信息] --> B{是否已授权?} B -- 是 --> C[直接获取 userInfo] B -- 否 --> D[显示引导按钮] D --> E{用户点击?} E -- 是 --> F[调用 button open-type 触发授权] F --> G{授权成功?} G -- 是 --> H[更新 UI 显示信息] G -- 否 --> I[跳转设置页 wx.openSetting] I --> J{重新授权?} J -- 是 --> C J -- 否 --> K[降级体验：匿名模式/提示登录重要性]

关键代码示例如下：

async checkAndRequestUser() {
  const res = await wx.getSetting();
  if (res.authSetting['scope.userInfo']) {
    const userRes = await wx.getUserInfo();
    this.updateProfile(userRes.userInfo);
  } else {
    // 引导用户点击授权按钮
    this.setData({ showAuthModal: true });
  }
}

// 用户点击“去设置”后的处理
openSetting() {
  wx.openSetting({
    success: (res) => {
      if (res.authSetting['scope.userInfo']) {
        wx.getUserInfo({
          success: (infoRes) => {
            this.updateProfile(infoRes.userInfo);
          }
        });
      }
    }
  });
}

4. 架构设计建议与最佳实践

• 权限前置化：在关键功能入口前预判权限状态，避免运行时阻塞。
• UI 分层设计：将授权按钮嵌入业务场景（如“登录后解锁更多功能”），提高接受率。
• 数据缓存机制：对已获取的 userInfo 进行本地存储，减少重复请求。
• 灰度迁移策略：对老用户保留兼容逻辑，新用户强制走新流程。
• 埋点监控：记录授权成功率、拒绝率、重试行为，用于优化引导策略。
• 合规性考量：确保 desc 字段描述清晰，符合《微信小程序平台运营规范》。
• 多端一致性：若同时开发 H5 或 App，需抽象统一的身份认证层。
• 测试覆盖：模拟不同授权状态（允许、拒绝、从未询问）下的表现。
• 基础库版本检测：针对低版本客户端提供降级方案。
• 服务端配合：userInfo 中的 encryptedData 需配合 sessionKey 解密，注意时效性。