最新wx.getUserProfile 踩坑,正确的使用方法!

微信官方团队宣布从4月13日起,小程序不再支持wx.getUserInfo,开发者需使用wx.getUserProfile接口获取用户信息。wx.getUserProfile必须由用户手动触发,不能在wx.login回调中自动调用,否则会引发错误。正确做法是在按钮点击事件中调用wx.getUserProfile,然后依次进行登录、数据解密等操作。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

微信官方团队发布了一个调整通知:《小程序登录、用户信息相关接口调整说明》,公告明确从4月13日起,新发布的小程序不能使用wx.getUserInfo,要用wx.getUserProfile替代

容易踩到的坑:

不能在调用 wx.login 等过程的回调函数中,自动调用 wx.getUserProfile 来触发授权行为,因为 wx.getUserProfile 只能由用户手动触发。否则,系统会抛出异常:error msg: getUserProfile:fail can only be invoked by user TAP gesture

wx.login和wx.getUserProfile正确使用代码:

//wxml
<button bindtap="getUserProfile"> 获取头像昵称 </button>
//getUserProfile 回调里面嵌套wx.login
getUserProfile{
    wx.getUserProfile({
        desc: '用于完善会员资料',
        success: function (userInfoRes) {
            //...

            //调用 wx.login 登录接口
            wx.login({
                success: function (res) {
                    //换取openid & session_key
                    wx.request({
                        url: wx.getStorageSync('domainName') + '/WxOpen/OnLogin',
                        method: 'POST',
                        header: { 'content-type': 'application/x-www-form-urlencoded' },
                        data: {
                            code: res.code
                        },
                        success: function (json) {
                            var result = json.data;
                            if (result.success) {
                                wx.setStorageSync('sessionId', result.sessionId);
                                //校验
                                wx.request({
                                    url: wx.getStorageSync('domainName') + '/WxOpen/CheckWxOpenSignature',
                                    method: 'POST',
                                    header: { 'content-type': 'application/x-www-form-urlencoded' },
                                    data: {
                                        sessionId: result.sessionId,//wx.getStorageSync('sessionId'),
                                        rawData: userInfoRes.rawData,
                                        signature: userInfoRes.signature
                                    },
                                    success: function (json) {
                                        console.log(json.data);
                                    }
                                });

                                //解密数据(建议放到校验success回调函数中,此处仅为演示)
                                wx.request({
                                    url: wx.getStorageSync('domainName') + '/WxOpen/DecodeEncryptedData',
                                    method: 'POST',
                                    header: { 'content-type': 'application/x-www-form-urlencoded' },
                                    data: {
                                        'type': "userInfo",
                                        sessionId: result.sessionId,//wx.getStorageSync('sessionId'),
                                        encryptedData: userInfoRes.encryptedData,
                                        iv: userInfoRes.iv
                                    },
                                    success: function (json) {
                                        console.log('数据解密:', json.data);
                                    }
                                });

                            } else {
                                console.log('储存session失败!', json);
                            }
                        }
                    })
                }
            })
        }
    });
}
### 微信小程序 `getUserProfile` 接口使用详解 #### 调用条件 为了安全性和用户体验考虑,此接口仅能在页面产生点击事件之后被调用[^1]。 #### 函数签名 ```javascript wx.getUserProfile(Object object) ``` #### 参数说明 - `object.success`: 接口调用成功的回调函数,返回参数包含用户信息对象 `userInfo` 和原始数据字符串 `rawData` 等。 - `object.fail`: 接口调用失败的回调函数。 - `object.complete`: 接口调用结束后的回调函数(无论成功与否)。 #### 用户授权提示 每次请求都会显示一个授权对话框给用户,只有当用户同意授权后才会返回用户的个人信息[^2]。 #### 示例代码 下面是一个简单的例子来展示如何利用这个API获取并处理用户资料: ```javascript Page({ handleGetUserProfile() { wx.getUserProfile({ desc: '用于完善会员资料', // 声明获取用户个人信息后的用途,后续会展示在弹窗中,请谨慎填写 success(res) { console.log('User Info:', res.userInfo); const { nickName, avatarUrl } = res.userInfo; // 存储到本地缓存或其他操作... try { wx.setStorageSync('nickName', nickName); wx.setStorageSync('avatarUrl', avatarUrl); } catch (e) { console.error(e.message); } }, fail(err) { console.warn('Failed to get user profile.', err); } }); } }); ``` 上述代码片段展示了如何定义一个名为 `handleGetUserProfile` 的方法,在其中调用了 `wx.getUserProfile()` 来向用户请求其个人资料权限。如果用户授予了访问权,则可以进一步保存这些信息或者执行其他逻辑;反之则记录错误日志以便调试。 #### 判断登录状态的方法变更 不同于旧版通过 `wx.getSetting` 方法检查登录状态的做法,现在推荐使用 `wx.setStorageSync` 或者类似的存储机制来进行管理。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

时光机上敲代码

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值