23年9月最新微信小程序 手机号授权 (uniapp+盛派SDK) 帮你踩坑
一、背景
微信小程序手机号授权接口，从23年8月开始实行付费验证。
文档地址：https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/getRealtimePhoneNumber.html
新版手机号授权说明如下：
自2023年8月28日起
【手机号实时验证组件】将需要付费使用。标准单价为：每次组件调用成功，收费0.04元。
【手机号快速验证组件】将需要付费使用。标准单价为：每次组件调用成功，收费0.03元。
两者组件区别是：
- 【手机号实时验证组件】：平台会对号码进行验证，但不保证是实时验证
- 【手机号实时验证组件】：在每次请求时，平台均会对用户选择的手机号进行实时验证
小程序后台付费管理页面，可以购买次数。如下图（每个小程序账号两个组件各有1000次体验额度，开发测试可以用）
用这个组件可以直接用code获取用户手机号，不需要再用SessionKey去解密手机号了。
正好要做一个小程序项目，打算用新的组件做用户授权。
前端使用：HBuilderX 开发 uniapp（可以生成H5 、APP 和 微信小程序等多家小程序）
后端使用：C# + 盛派SDK
二、划重点
1、手机号授权 getPhoneNumber 返回的 {code} 与 wx.login 返回的 {code} 作用是不一样的，不能混用且只能消费一次。
2、wx.login 是静默，可以在用户无感知的情况下用 {code} 换取用户的 【OpenId】。
3、手机号验证组件 会弹出授权窗口（如下图），只有用户点击同意才授权成功，可以拿到手机号。并且实时组件会发送验证码。
三、uniapp前端
uniapp 手机号页面代码 ，使用快速还是实时，看自己需求。
手机号快速验证组件：
1 <template> 2 <view class="content"> 3 <view class="text-area"> 4 <button open-type="getPhoneNumber" @getphonenumber="GetPhoneNumber">手机号快捷登录</button> 5 </view> 6 </view> 7 </template>
手机号实时验证组件(会有验证码)：
1 <template> 2 <view class="content"> 3 <view class="text-area"> 4 <button open-type="getRealtimePhoneNumber"@getrealtimephonenumber="getPhone">获取实时手机号码</button> 5 </view> 6 </view> 7 </template>
JS代码：
1 methods: {
2 //手机号授权
3 GetPhoneNumber: function(Res) {
4 let Container = this;
5 // 动态令牌
6 var Code = Res.detail.code;
7 },
8 }
如果获取到的code为空，可能是用户拒绝了授权，可以弹出【友好提示】请求再次授权。
用户授权成功后，拿到的正确响应如下图：
我们只需要用到code
用户拒绝授权，会得到这样的响应：
四、C#服务端
这里用到盛派的微信小程序SDK，需要引用相关NuGet包：Senparc.Weixin.WxOpen
C#代码：
使用盛派SDK：BusinessApi.GetUserPhoneNumber(" 可以放微信accessToken或者微信小程序AppId "," 前端手机号授权得到的code ")
盛派官方推荐使用 微信小程序AppId，系统会自动管理密钥的周期（如果过期会再次更新）
1 try
2 {
3 #region code换用户手机号
4
5 //code换用户手机号
6 var UserMobilePhoneResult = BusinessApi.GetUserPhoneNumber("微信的动态令牌AccessToken", "前端拿到的code");
7 //手机号
8 String MobilePhone = MemberUserMobilePhoneResult.phone_info.purePhoneNumber;
9
10 #endregion code换用户手机号
11 }
12 catch (ErrorJsonResultException err)
13 {
14 return (XCXAccountUpdateMemberUserMobilePhoneResponse)SetExceptionError(MyResponse, err, -1, "手机号获取失败，" + "错误原因:" + err.Message);
15 }
16 catch (Exception err)
17 {
18 return (XCXAccountUpdateMemberUserMobilePhoneResponse)SetExceptionError(MyResponse, err, -1, "手机号获取失败");
19 }
我项目有windows service (服务) 在服务器上24小时循环检查，统一生成微信小程序动态令牌AccessToken，所以我这里用的密钥。接口地址：https://developers.weixin.qq.com/miniprogram/dev/OpenApIdoc/mp-access-token/getStableAccessToken.html
盛派SDK也可以，获取微信的小程序动态令牌AccessToken：
String AccessToken = AccessTokenContainer.GetAccessToken(WXXCXAppID);
如果遇到这样的错误，说明没有注册盛派相关服务。可以看官方解决文档：https://www.cnblogs.com/szw/p/9265828.html
注册代码：
在global.asax.cs 文件的 Application_Start() 方法中，加入代码（注意 using 两个命名空间：Senparc.CO2NET 和 Senparc.Weixin）：
1 #region 注册（激活）盛派SDK 微信使用
2 try
3 {
4 //设置全局 Debug 状态
5 var isGLobalDebug = true;
6 var senparcSetting = SenparcSetting.BuildFromWebConfig(isGLobalDebug);
7 //CO2NET全局注册，必须！
8 var register = RegisterService.Start(senparcSetting).UseSenparcGlobal();
9 //设置微信 Debug 状态
10 var isWeixinDebug = true;
11 var senparcWeixinSetting = SenparcWeixinSetting.BuildFromWebConfig(isWeixinDebug);
12 //微信全局注册，必须！
13 register.UseSenparcWeixin(senparcWeixinSetting, senparcSetting);
14
15 //根据APPId判断获取
16 if (!AccessTokenContainer.CheckRegistered(WXXCXAppId))//检查是否已经注册
17 {
18 //注册小程序凭证
19 await AccessTokenContainer.RegisterAsync(小程序的AppId, 小程序的密钥AppSecret, "【xxxxxxxx】小程序");
20 }
21 }
22 catch (Exception ex)
23 {
24 Senparc.CO2NET.Trace.SenparcTrace.SendCustomLog("系统日志", ex.Message);
25 }
26 #endregion 注册（激活）盛派SDK 微信使用
