小程序登录、用户信息相关接口调整说明

矫情吗；* 2022-11-16 10:38 96阅读 0赞

为优化用户的使用体验，平台将进行以下调整：

1.  2021年2月23日起，若小程序已在微信开放平台进行绑定，则通过wx.login接口获取的登录凭证可直接换取unionID
2.  2021年4月13日后发布的小程序新版本，无法通过wx.getUserInfo与<button open-type="getUserInfo"/>获取用户个人信息（头像、昵称、性别与地区），将直接获取匿名数据（包括userInfo与encryptedData中的用户个人信息），获取加密后的openID与unionID数据的能力不做调整。此前发布的小程序版本不受影响，但如果要进行版本更新则需要进行适配。
3.  新增getUserProfile接口（基础库2.10.4版本开始支持），可获取用户头像、昵称、性别及地区信息，开发者每次通过该接口获取用户个人信息均需用户确认。具体接口文档：[《getUserProfile接口文档》][getUserProfile]
4.  由于getUserProfile接口从2.10.4版本基础库开始支持（覆盖微信7.0.9以上版本），考虑到开发者在低版本中有获取用户头像昵称的诉求，对于未支持getUserProfile的情况下，开发者可继续使用getUserInfo能力。开发者可参考[getUserProfile接口文档中的示例代码][getUserProfile 1]进行适配。

**请使用了wx.getUserInfo接口或<button open-type="getUserInfo"/>的开发者尽快适配。**[开发者工具][Link 1][1.05.2103022版本][Link 1]开始支持getUserProfile接口调试，开发者可下载该版本进行改造。

小游戏不受本次调整影响。

## 一、调整背景 ##

很多开发者在打开小程序时就通过组件方式唤起getUserInfo弹窗，如果用户点击拒绝，无法使用小程序，这种做法打断了用户正常使用小程序的流程，同时也不利于小程序获取新用户。

## 二、调整说明 ##

**通过wx.login接口获取的登录凭证可直接换取unionID**

若小程序已在微信开放平台进行绑定，原wx.login接口获取的登录凭证若需换取unionID需满足以下条件：

1.  如果开发者帐号下存在同主体的公众号，并且该用户已经关注了该公众号
2.  如果开发者帐号下存在同主体的公众号或移动应用，并且该用户已经授权登录过该公众号或移动应用

**2月23日后，开发者调用wx.login获取的登录凭证可以直接换取unionID，无需满足以上条件。**

**回收wx.getUserInfo接口可获取用户个人信息能力**

**4月13日后发布的新版本小程序，开发者调用wx.getUserInfo或<button open-type="getUserInfo"/>将不再弹出弹窗，直接返回匿名的用户个人信息，获取加密后的openID、unionID数据的能力不做调整。**

具体变化如下表：

![9a293ca4cb700177765ebb4263b2c515.png][]

即wx.getUserInfo接口的返回参数不变，但开发者获取的userInfo为匿名信息。

![2bae11cfadffe422ad5f2f85ffdd71e5.png][]

此外，针对scope.userInfo将做如下调整：

1.  若开发者调用wx.authorize接口请求scope.userInfo授权，用户侧不会触发授权弹框，直接返回授权成功
2.  若开发者调用wx.getSetting接口请求用户的授权状态，会直接读取到scope.userInfo为true

**新增getUserProfile接口**

**若开发者需要获取用户的个人信息（头像、昵称、性别与地区），可以通过wx.getUserProfile接口进行获取**，该接口从基础库2.10.4版本开始支持，该接口只返回用户个人信息，不包含用户身份标识符。该接口中desc属性（声明获取用户个人信息后的用途）后续会展示在弹窗中，请开发者谨慎填写**。开发者每次通过该接口获取用户个人信息均需用户确认，请开发者妥善保管用户快速填写的头像昵称，避免重复弹窗。**

**插件用户信息功能页**

插件申请获取用户头像昵称与用户身份标识符仍保留功能页的形式，不作调整。用户在[用户信息功能页][Link 2]中授权之后，插件就可以直接调用 wx.login 和 wx.getUserInfo 。

## 三、最佳实践 ##

调整后，开发者如需获取用户身份标识符只需要调用**wx.login**接口即可。

开发者若需要在界面中展示用户的头像昵称信息，可以通过**<open-data>**组件进行渲染，该组件无需用户确认，可以在界面中直接展示。

在部分场景（如社交类小程序）中，开发者需要在获取用户的头像昵称信息，可调用**wx.getUserProfile接口**，开发者每次通过该接口均需用户确认，请开发者妥善处理调用接口的时机，避免过度弹出弹窗骚扰用户。

[getUserProfile]: https://developers.weixin.qq.com/miniprogram/dev/api/open-api/user-info/wx.getUserProfile.html
[getUserProfile 1]: https://developers.weixin.qq.com/miniprogram/dev/api/open-api/user-info/wx.getUserProfile.html#%E7%A4%BA%E4%BE%8B%E4%BB%A3%E7%A0%81
[Link 1]: https://developers.weixin.qq.com/miniprogram/dev/devtools/nightly.html
[9a293ca4cb700177765ebb4263b2c515.png]: /images/20221022/8a46fb99d96d4a92aeb8583b8fa475df.png
[2bae11cfadffe422ad5f2f85ffdd71e5.png]: /images/20221022/a68eaaca7a854308a7e74422f59d27ba.png
[Link 2]: https://developers.weixin.qq.com/miniprogram/dev/framework/plugin/functional-pages/user-info.html