注意!!!由于近期在做博文搬迁,说明一下本文在其他公共博文平台的初次发布时间为:2021年10月21日

使用场景

  1. 微信公众号内嵌H5网页调用微信登录
  2. 在微信浏览器中的网页唤起微信登录界面

详情可以查阅微信登录官方文档 链接地址

功能思路

  1. 后台先在微信给开发者提供的测试账号平台上创建应用,并把前台开发同学的微信添加到这个平台中,用于提供测试公众号,平台地址
  2. 前台拼装各种微信登录必须的参数,并将页面跳转到微信指定的连接获取微信登录code参数
  3. 前台解析返回的链接,获取链接中的参数,并将code参数传给后台
  4. 由于后续获取的参数安全等级较高,所以后续的操作均由后台完成,并将数据存储在服务端
    • 后台通过code参数换取access_token参数和openid参数并存储在服务端
    • 后台再通过access_token参数和openid参数换取用户详细信息,并将这两步包装成接口,让前台调用,返回前端登录状态完成微信登录操作
  5. 如果access_token参数失效,使用refresh_token刷新即可,详细操作查阅文档,一般用不到这步

前端代码

1. 获取code

function getWXcode() {
	
	// 公众号的唯一标识,找公众号管理员提供
	var APPID = '公众号的appid';
	
	// 授权后重定向的回调链接地址,要使用encodeURIComponent()对其进行编码处理
	// !!!注意回调的域名必须先让公众号管理员添加到安全域名中,否则无法完成跳转
	var REDIRECT_URI = encodeURIComponent('授权后跳转回的页面');
	
	// 常量,返回类型,填写code即可
	var RESPONSE_TYPE = 'code';
	
	// 常量,应用授权作用域
	// snsapi_userinfo (弹出授权页面,可通过openid拿到昵称、性别、所在地。并且, 即使在未关注的情况下,只要用户授权,也能获取其信息 )
	// snsapi_base (不弹出授权页面,直接跳转,只能获取用户openid)
	var SCOPE = 'snsapi_userinfo' || 'snsapi_base';
	
	// 重定向后会带上state参数,开发者可以填写a-zA-Z0-9的参数值,最多128字节
	// 除了此项是非必须参数,其他都是必须要带的参数
	// 注意!!!该参数通常用于判断跳转回来之前的接口是什么作用,比如用于判断是第一次微信登录还是授权过的快速微信登录
	var STATE = '可以自定义的返回参数';
	
	// 无论直接打开还是做页面302重定向时候,必须带'#wechat_redirect'参数
	// 由于授权操作安全等级较高,所以在发起授权请求时,微信会对授权链接做正则强匹配校验,如果链接的参数顺序不对,授权页面将无法正常访问
	location.href =
		`https://open.weixin.qq.com/connect/oauth2/authorize?appid=${APPID}&redirect_uri=${REDIRECT_URI}&response_type=${RESPONSE_TYPE}&scope=${SCOPE}&state=STATE#wechat_redirect `;

}

2. 解析参数

function parseData() {
	
	// 截取地址栏?后面的内容
	var search = location.search.slice(1);
	
	// 用&标识分割成数组
	var arr = search.split('&');
	
	// 处理数组转换成对象,并返回
	var result = {};
	arr.forEach(function(item) {
		var itemArr = item.split('=');
		result[itemArr[0]] = itemArr[1];
	});
}

3. code传给后台,后台完成微信登录后续操作后,返回登录状态提示前端登录成功还是失败,然后前台继续后续业务逻辑代码编写

我是 fx67ll.com,如果您发现本文有什么错误,欢迎在评论区讨论指正,感谢您的阅读!
如果您喜欢这篇文章,欢迎访问我的 本文github仓库地址,为我点一颗Star,Thanks~ 😃
转发请注明参考文章地址,非常感谢!!!

Q.E.D.


Hi!欢迎访问 fx67ll.com 的个人博客站点!Code is my life ~