"获取用户信息出错？微信小程序GetUserInfo接口介绍及解决方法"

2024-04-23 00:50:46 搜狗SEO ℃

微信小程序getUserPortrait方法详解

微信小程序是一种轻量级应用，无需下载和安装即可直接运行。在微信小程序中，getUserPortrait 方法是用于获取当前登录用户的头像信息的一个 API，本文将介绍使用 getUserPortrait 方法获取用户头像信息的具体步骤及注意事项。

getUserPortrait 方法介绍

getUserPortrait 方法是微信小程序中的一个 API，用于获取当前登录用户的头像信息。该方法需要在小程序的页面中调用，并且需要传入一个 callback 函数作为参数。该回调函数会在获取用户头像信息成功后被调用，并接收到一个对象作为参数，该对象包含了用户的头像信息。

使用方法

1、在小程序的页面中调用 getUserPortrait 方法。

wx.getUserPortrait({
  success: function (res) {
    console.log(res);
  },
  fail: function (err) {
    console.log(err);
  }
});

2、在 success 回调函数中，可以获取到用户的头像信息。

wx.getUserPortrait({
  success: function (res) {
    console.log(res); // 输出用户头像信息
    var userInfo = res.userInfo; // 获取用户昵称等信息
    console.log(userInfo); // 输出用户昵称等信息
  },
  fail: function (err) {
    console.log(err);
  }
});

在调用 getUserPortrait 方法后，如果用户已经成功授权，则可以获取到用户的头像信息。在获取用户头像信息成功后，通过 res.userInfo 可以获取到用户的昵称等信息。

注意事项

1、getUserPortrait 方法需要在小程序的页面中调用，不能在 app.js、app.json、app.wxss 等文件中调用。

2、getUserPortrait 方法需要在用户授权后才能成功获取到用户的头像信息。在使用该方法前，需要先引导用户进行授权操作。

3、如果用户拒绝授权或者授权失败，回调函数中的 err 参数会包含错误信息，可以通过 err.detailMsg 和 err.errMsg 属性获取到具体的错误信息。

示例代码

以下是一个简单的示例代码，演示了如何使用 getUserPortrait 方法获取用户头像信息：

Page({
  data: {
    userInfo: null, // 存储用户头像信息的对象
    hasUserInfo: false // 标识用户是否已经授权过信息，默认为 false
  },
  onLoad: function () {
    this.getUserInfo(); // 获取用户头像信息的方法
  },
  getUserInfo: function () {
    var that = this;
    wx.getSetting({ // 获取用户的授权情况
      success: function (res) {
        if (res.authSetting['scope.userInfo']) { // 如果用户已经授权过信息
          that.setData({ // 更新 hasUserInfo 的值，表示用户已经授权过信息
            hasUserInfo: true,
            userInfo: that.data.userInfo || {} // 如果之前已经有用户头像信息，则直接使用之前的值，否则使用空对象作为初始值
          });
        } else { // 如果用户还没有授权过信息，则引导用户进行授权操作
          wx.authorize({ // 发起授权请求，请求用户授权 access_token、openid、nickname、avatarUrl、gender、city、province、country、language、email、phoneNumbers、address、remarks（需用户授权）等权限
            scope: 'scope.userInfo', // 请求用户授权的信息范围，包括基本信息和详细信息两部分，基本信息包括 openid、nickname、avatarUrl、gender，详细信息包括 city、province、country、language、email、phoneNumbers、address、remarks（需用户授权）等字段
            success: function () { // 如果授权成功，则更新 hasUserInfo 的值，表示用户已经授权过信息，并调用 getUserPortrait 方法获取用户头像信息
              that.setData({ // 更新 hasUserInfo 的值，表示用户已经授权过信息
                hasUserInfo: true,
                userInfo: that.data.userInfo || {} // 如果之前已经有用户头像信息，则直接使用之前的值，否则使用空对象作为初始值
              });
              that.getUserPortrait(); // 调用 getUserPortrait 方法获取用户头像信息的方法
            },
            fail: function () { // 如果授权失败，则提示用户无法获取头像信息的原因
              // 弹出“无法获取您的头像信息”等文字提示框和错误码（错误码详见下表1）以及错误信息的详细描述文本（可选）等
            }
          });
        }
      }
    });
  },
  getUserPortrait: function () { // 获取用户头像信息的方法
    var that = this;
    wx.getUserPortrait({
      success: function (res) {
        var userInfo = that.data.userInfo || {}; // 获取之前存储的用户头像信息
        userInfo.avatarUrl = res.userInfo.avatarUrl; // 更新用户头像信息
        that.setData({ // 保存用户头像信息到 data 中
          userInfo: userInfo
        });
      }
    });
  }
});