小程序getuserinfo接口报错，新版要如何获取用户信息？

在微信小程序的开发历程中，获取用户信息是一个常见的需求，许多开发者，尤其是维护旧项目或参考过时教程的新手，常常会遇到 wx.getUserInfo 或相关方法报错的问题，这并非代码逻辑的失误，而是源于微信平台对用户隐私保护策略的重大调整，本文将深入剖析这一问题的根源，并提供清晰、可行的解决方案。

错误的根源：接口调整与隐私保护

问题的核心在于，微信官方为了更好地保护用户隐私，对获取用户信息的接口进行了多次迭代和限制,理解这些变化是解决报错的第一步。

我们需要区分几个关键的接口：

1. wx.getUserInfo：这是最早的获取用户信息接口，在调整后，调用此接口将不会弹出授权弹窗，而是直接返回匿名的用户信息，例如昵称固定为“微信用户”，头像为默认灰色头像，它虽然不会“报错”,但已无法获取到真实的用户数据。

2. ：这是曾经的主流方案，通过在按钮上设置 open-type="getUserInfo"，用户点击按钮后会主动拉起授权弹窗，自2021年4月13日起，微信官方正式废弃了此方式，使用该属性的按钮点击后，同样只能获取到匿名信息，无法再引导用户进行真实授权，这便是许多开发者遇到“获取不到信息”或“功能失效”的主要原因。

3. wx.getUserProfile：这是当前官方推荐的、唯一能够获取用户真实信息的接口，它的设计理念是“在用户主动触发的场景下，由开发者明确告知用途后，获取用户信息”。

正确的解决方案：使用 wx.getUserProfile

要解决 getuserinfo 相关的报错或失效问题，必须迁移至 wx.getUserProfile，其使用方法非常明确,必须与用户的点击事件绑定。

实现步骤如下：

第一步：在WXML中放置一个按钮

这个按钮不再需要特殊的 open-type,只需绑定一个点击事件即可。

<!-- pages/profile/profile.wxml -->
<view class="container">
  <button bindtap="getUserProfile">获取用户信息</button>
  <view wx:if="{{userInfo}}">
    <image src="{{userInfo.avatarUrl}}" mode="aspectFit"></image>
    <text>{{userInfo.nickName}}</text>
  </view>
</view>

第二步：在JS中实现事件处理函数

在绑定的 getUserProfile 函数中调用 wx.getUserProfile 接口。

// pages/profile/profile.js
Page({
  data: {
    userInfo: null,
  },
  getUserProfile(e) {
    wx.getUserProfile({
      desc: '用于完善会员资料', // 声明获取用户个人信息后的用途，后续会展示在弹窗中
      success: (res) => {
        console.log('获取用户信息成功', res.userInfo);
        this.setData({
          userInfo: res.userInfo,
        });
        // 可以将 userInfo 存储到全局或缓存中，避免重复授权
        wx.setStorageSync('userInfo', res.userInfo);
      },
      fail: (err) => {
        console.log('用户拒绝授权', err);
        wx.showToast({
          title: '您拒绝了授权',
          icon: 'none',
        });
      }
    })
  }
})

为了更直观地对比新旧方案的差异,可以参考下表：

特性维度	旧方案 (<button open-type="getUserInfo">)	新方案 (<button bindtap> + wx.getUserProfile)
触发方式	点击带有 open-type 的按钮	点击任意绑定 tap 事件的元素（通常是按钮）
授权弹窗	由系统自动拉起	由开发者在 wx.getUserProfile 调用时主动拉起
用途声明	无，用户不知情	必须提供 desc 参数，明确告知用途
当前状态	已废弃，仅返回匿名信息	推荐使用，可获取真实信息
用户体验	较为突兀，信息不透明	更加透明，用户知情权得到保障

最佳实践与注意事项

在实际应用中，应避免在页面加载（onLoad）时自动调用 wx.getUserProfile，这会违反“用户主动触发”的原则，导致调用失败，最佳实践是，在用户确实需要使用个人信息的功能入口（如“个人中心”、“登录”按钮）处，再引导其点击授权，获取到信息后，应妥善存储在本地缓存或全局状态中，以便后续使用,避免频繁打扰用户。

---

相关问答FAQs

解答： 这是因为微信官方在2021年4月13日调整了用户信息接口策略，为了加强隐私保护，<button open-type="getUserInfo"> 和 wx.getUserInfo 这两种方式已无法再获取用户的真实昵称、头像等敏感信息，它们只会返回匿名数据，这是平台层面的限制，并非代码错误，您需要采用新的 wx.getUserProfile 接口来替代。

解答： 不可以。wx.getUserProfile 接口被严格限制为必须由用户主动触发的事件（如 tap 点击事件）来调用，如果在 onLoad、onShow 等非用户交互事件中调用，接口会直接返回失败，这是微信为了防止应用在用户不知情的情况下“静默”获取其信息而设定的安全机制,正确的做法是将其放在一个按钮的点击事件处理函数中。