目录

写在前面

对于刚接触微信小程序单应用开发，或者一直没有关注微信小程序官方文档调整的朋友，可能会遇到这样的情况：当你想要实现微信用户授权登录时，发现之前的用户授权弹窗没有了，并且获取到的用户信息中的用户头像是灰色的，名字统一为微信用户。没错，微信官方对用户头像昵称获取规则进行了调整！

微信小程序于2022年11月宣布取消主动获取用户名和头像功能，wx.和wx.将失效，wx.接口直接获取用户信息，实现微信身份登录。参考：用户信息接口调整说明、小程序用户头像昵称获取规则调整公告

以下公告信息来自微信官方：

更新日期：2022 年 11 月 9 日

由于PC/平台“头像昵称填充能力”兼容性问题，从2.27.1以下版本接入，小程序会通过wx.接口正常返回用户的头像昵称，插件也会通过wx.接口正常返回用户的头像昵称。

更新日期：2022 年 9 月 28 日

考虑到近期开发者对小程序用户头像、昵称获取规则调整的反馈，平台将接口回收截止时间由2022年10月25日延长至2022年11月8日24时。

调整背景

在小程序中，开发者可以通过wx.接口直接获取用户的信息，实现微信身份登录，并支持开发者在多个小程序或其他应用之间匿名关联同一个用户。

同时，为了满足部分小程序业务需要创建用户昵称和头像的需求，平台提供了wx.接口，支持在用户授权的前提下，快速使用自己的微信昵称和头像。

但实践中发现，部分小程序在用户刚打开小程序时，就要求收集用户的微信昵称、头像，或以支付前等不合理方式要求授权，若用户拒绝授权，则无法使用小程序或相关功能。在用户个人信息已被获取的情况下，用户的微信昵称、头像并非用户使用小程序的必要条件。为减少此类不合理强制授权，特做如下调整。

调整说明

自2022年10月25日24时起（以下简称“生效日”），用户头像昵称获取规则调整如下：

自生效日起，小程序wx.接口将被撤销：生效后发布的小程序新版本，将恢复默认灰色头像通过wx.接口获取用户头像，昵称统一返回“微信用户”。生效前发布的小程序版本不受影响，但如果要升级版本则需要适配。自生效日起，插件使用wx.接口获取用户昵称头像将被撤销：生效后发布的小程序新版本，将恢复默认灰色头像通过wx.接口获取用户头像，昵称统一返回“微信用户”。生效前发布的插件版本不受影响，但如果要升级版本则需要适配。通过wx.和wx.接口获取用户昵称头像的功能不受影响。 “头像昵称填充能力”支持获取用户头像昵称：若业务需要获取用户头像昵称，可使用“头像昵称填充能力”（基础库2.21.2版本支持，覆盖iOS和微信8.0.16及以上版本），具体做法见下文“最佳实践”。小程序wx.和插件wx.接口兼容基础库2.27.1以下版本头像昵称获取要求：对于低版本基础库和微信客户端访问，小程序通过wx.接口正常返回用户头像昵称，插件通过wx.接口正常返回用户头像昵称。开发者可继续使用以上能力向下兼容。

对于上述3个，wx.、wx.基础库版本支持能力、头像昵称填充能力的详细对比如下表：

* 对于低版本基础库请参考兼容文档进行兼容处理

请已经使用wx.接口的小程序开发者、插件开发者尽快适配，小游戏不受本次调整影响。

最佳实践

小程序可以利用个人中心或设置页的头像、昵称填写功能，让用户补全自己的个人信息：

——— 发自：微信团队 2022年5月9日

官方 API

wx.() | 微信开放文档

wx.() | 微信开放文档

官方公告

关于小程序用户头像昵称获取规则调整的公告 | 微信开放社区

小程序登录及用户信息相关接口调整说明 | 微信开放社区