.NET微信网页开发之通过UnionID机制解决多应用用户帐号统一问题

背景

随着公司微信相关业务场景的不断拓展，从最初的一个微信移动应用、然后发展成微信公众号应用、然后又有了微信小程序应用。但是随着应用的拓展，如何保证相同用户的微信用户在不同应用中登录的同一个账号呢？今天的主题就来了.NET微信网页开发之通过UnionID机制解决多应用用户帐号统一问题。

UnionID 机制

如果开发者拥有多个移动应用、网站应用、和公众账号（包括小程序），可通过 UnionID 来区分用户的唯一性，因为只要是同一个微信开放平台账号下的移动应用、网站应用和公众账号（包括小程序），用户的 UnionID 是唯一的。换句话说，同一用户，对同一个微信开放平台下的不同应用，UnionID是相同的。

获取用户基本信息(UnionID机制)

在关注者与公众号产生消息交互后，公众号可获得关注者的OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的。对于不同公众号，同一用户的openid不同）。公众号可通过本接口来根据OpenID获取用户基本信息，包括语言和关注时间。

请注意，如果开发者有在多个公众号，或在公众号、移动应用之间统一用户账号的需求，需要前往微信开放平台（open.weixin.qq.com）绑定公众号后，才可利用UnionID机制来满足上述需求。

微信开放平台配置

• 登录地址：https://open.weixin.qq.com/

微信公众号微信登录配置

在基本配置中获取微信公众号的appid和appsecrect（一定是要自己公众号的），白名单是你在本地调试的微信项目的时候需要添加的你本地的ip地址，不然获取不到你想要的accsee_token。

配置服务器地址（url）：这里是你的项目与微信服务器通讯的地方，一定不能填错，Token是你项目中的，将其复制到这里即可，消息加密解密密钥是微信端随机生成的。

在微信公众号设置设置对应业务域名，js接口安全域名，以及网页授权域名：

微信网页公众号获取用户UnionID（用户统一标识）

注意：用户统一标识（针对一个微信开放平台账号下的应用，同一用户的 unionid 是唯一的），只有当scope为"snsapi_userinfo"时返回

用户同意授权获取code

在确保微信公众账号拥有授权作用域（scope参数）的权限的前提下（已认证服务号，默认拥有scope参数中的snsapi_base和snsapi_userinfo 权限），引导关注者打开如下页面：

若提示“该链接无法访问”，请检查参数是否填写错误，是否拥有scope参数对应的授权作用域权限。跳转回调redirect_uri，应当使用https链接来确保授权code的安全性，并且是在微信公众号后台配置的网页授权域名的访问地址。

• https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect

请求参数：

通过code获取用户UnionID（用户统一标识）

• 获取code后，请求以下链接获取access_token：https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code

请求参数：

返回参数：

请求示例代码：

    public class WeChatLogin : Controller{/// <summary>/// 获取用户UnionID（用户统一标识）/// </summary>/// <param name="state">自定义参数</param>/// <param name="code">通过用户授权后得到的code</param>/// <returns></returns>public async Task<Response> GetWeChatUnionID(string state, string code){string appId = "YourAppId";string appSecret = "YourAppSecret";string requestUrl = $"https://api.weixin.qq.com/sns/oauth2/access_token?appid={appId}&secret={appSecret}&code={code}&grant_type=authorization_code";using (var httpClient = new HttpClient()){var httpRequest = new HttpRequestMessage(HttpMethod.Get, requestUrl);using (var response = await httpClient.SendAsync(httpRequest)){if (response.IsSuccessStatusCode){var responseString = await response.Content.ReadAsStringAsync();var responseData = JsonConvert.DeserializeObject<WeChatTokenResponse>(responseString);return new Response{Code = 1,Message = responseData.UnionId};}else{var errorResponseString = await response.Content.ReadAsStringAsync();var errorData = JsonConvert.DeserializeObject<ErrorResponse>(errorResponseString);return new Response{Code = 0,Message = $"Failed to get access token: {errorData.ErrMsg}"};}}}}}public class WeChatTokenResponse{[JsonProperty("access_token")]public string AccessToken { get; set; }[JsonProperty("expires_in")]public int ExpiresIn { get; set; }[JsonProperty("refresh_token")]public string RefreshToken { get; set; }[JsonProperty("openid")]public string OpenId { get; set; }[JsonProperty("scope")]public string Scope { get; set; }[JsonProperty("is_snapshotuser")]public int IsSnapshotUser { get; set; }[JsonProperty("unionid")]public string UnionId { get; set; }}public class ErrorResponse{[JsonProperty("errcode")]public int ErrCode { get; set; }[JsonProperty("errmsg")]public string ErrMsg { get; set; }}

.NET微信网页开发相关文章教程

https://github.com/YSGStudyHards/DotNetGuide

参考文章

• https://developers.weixin.qq.com/doc/offiaccount/User_Management/Get_users_basic_information_UnionID.html