开发者必备：微信小程序获取手机号getPhoneNumber指南

在微信小程序中获取用户手机号的完整指南

一、前言

在微信小程序中，获取用户手机号对于开发者来说是一个非常重要的需求。通过获取用户手机号，开发者可以进行后续的业务开发，如发送短信验证码、进行用户身份验证等。微信官方提供了 getPhoneNumber 方法，开发者可以通过此方法获取用户绑定的微信手机号。

二、getPhoneNumber 方法介绍

getPhoneNumber 方法是一个异步方法，它的主要参数如下：

• success ：成功回调函数，在用户授权成功后被调用。
• fail ：失败回调函数，在用户授权失败后被调用。
• complete ：完成回调函数，无论授权成功还是失败都会被调用。

三、getPhoneNumber 方法注意事项

在使用 getPhoneNumber 方法时，需要特别注意以下几点：

• 必须在用户点击按钮或其他控件后才能调用 getPhoneNumber 方法，否则会触发授权失败事件。
• 用户需要先授权才能获取手机号，如果用户未授权，则会触发授权失败事件。
• 获取手机号需要用户进行二次确认，如果用户未进行二次确认，则会触发授权失败事件。

四、getPhoneNumber 方法代码示例

wx.getPhoneNumber({
  success: function (res) {
    // 用户授权成功，获取到用户手机号
    console.log(res.phoneNumber)
  },
  fail: function (res) {
    // 用户授权失败
    console.log(res.errMsg)
  },
  complete: function (res) {
    // 无论授权成功还是失败，都会执行该回调函数
    console.log(res.errMsg)
  }
})

五、getPhoneNumber 方法常见问题

1. 为什么用户点击了授权按钮，但是依然获取不到手机号？

可能是因为用户未进行二次确认。在用户点击授权按钮后，微信会弹出一个二次确认弹窗，用户需要点击“确定”按钮才能完成授权。

2. 为什么用户授权成功了，但是依然获取不到手机号？

可能是因为用户之前已经授权过其他小程序获取手机号，此时微信会直接返回之前授权的小程序的手机号。开发者需要在 getPhoneNumber 方法中判断返回的手机号是否为自己小程序的手机号。

3. 如何判断返回的手机号是否为自己小程序的手机号？

可以通过比较返回的手机号与小程序的 appId 来判断。如果返回的手机号与小程序的 appId 一致，则说明该手机号是为自己小程序的手机号。

4. 为什么我调用 getPhoneNumber 方法时提示权限不足？

可能是因为小程序没有申请 scope.userPhoneNumber 权限。开发者需要在小程序的 app.json 文件中添加 scope.userPhoneNumber 权限。

5. 为什么我调用 getPhoneNumber 方法时提示服务不可用？

可能是因为微信服务器繁忙或者网络连接不稳定。开发者可以稍后重试。

六、结语

getPhoneNumber 方法是微信小程序提供的获取用户手机号的方法，开发者们可以利用该方法来进行后续的业务开发。在使用 getPhoneNumber 方法时，需要注意一些事项，例如必须在用户点击按钮或其他控件后才能调用该方法，用户需要先授权才能获取手机号，获取手机号需要用户进行二次确认等。如果开发者们在使用 getPhoneNumber 方法时遇到问题，可以参考本文中的常见问题解答。