微信小程序登陆,后端接口实现 - springboot

时间:2023-01-17 09:53:11

登录流程

微信小程序登陆,后端接口实现 - springboot

1、通过调用wx.login获取登录凭证(code)

2、前端将code提交给服务器,springboot访问 auth.code2Session,使用 code 换取 openid、unionid、session_key 等信息。

3、完成登录操作,返回token给前端。

测试发现,个人小程序无法获取unionid


步骤一

通过调用wx.login获取登录凭证(code)

示例:uni-app项目中,使用uni.login获取登录凭证(code)

// 微信小程序
// #ifdef MP-WEIXIN

uni.login({
	provider: 'weixin',
	success: function(loginRes) {
		if (loginRes.errMsg == "login:ok") {
			//提交code到服务器,完成登录操作
			doWxLogin({
				code: loginRes.code
			}).then(res => {
				console.log(res)
				//。。。
			})
		}
	}
});

// #endif

wx.login

调用接口获取登录凭证(code)。通过凭证进而换取用户登录态信息,包括用户在当前小程序的唯一标识(openid)、微信开放平台帐号下的唯一标识(unionid,若当前小程序已绑定到微信开放平台帐号)及本次登录的会话密钥(session_key)等。用户数据的加解密通讯需要依赖会话密钥完成。

code,用户登录凭证(有效期五分钟)。开发者需要在开发者服务器后台调用 auth.code2Session,使用 code 换取 openid、unionid、session_key 等信息。

  • openid:指的微信用户在微信的某个应用中的唯一标识。
  • unionid:指的微信用户的唯一标识。(相当于微信用户ID)
  • 微信某个应用:指的是 公众号、小程序、开放平台等。
  • 若要开发多个微信应用,应当获取微信用户的唯一标识 unionid。

目前小程序开发者可以通过 wx.login 接口直接获取用户的 openId 与 unionId 信息,实现微信身份登录。对许多小程序使用场景,用户无需提供头像昵称。如有必要场景需收集用户头像昵称,可在个人中心或设置等页面让用户完善个人资料。如业务需获取用户头像、昵称,可以使用「头像昵称填写能力」

wx.getUserProfile

获取用户信息。页面产生点击事件(例如 buttonbindtap 的回调中)后才可调用,每次请求都会弹出授权窗口,用户同意后返回 userInfo

属性 类型 说明 最低版本
signature string 使用 sha1( rawData + sessionkey ) 得到字符串,用于校验用户信息,详见 用户数据的签名验证和加解密 2.10.4
encryptedData string 包括敏感数据在内的完整用户信息的加密数据,详见 用户数据的签名验证和加解密 2.10.4
iv string 加密算法的初始向量,详见 用户数据的签名验证和加解密 2.10.4

2022年11月8日24时起,已废弃。wx.getUserProfile,在uni-app中是uni.getUserProfile。若该方法未失效,可使用code换取的session_key将encryptedData解密,获取用户信息。


步骤二

前端将code提交给服务器,springboot访问 auth.code2Session,使用 code 换取 openid、unionid、session_key 等信息。

  • 在换取到openid/unionid后,查找用户表,若有匹配的用户则自动登录,否则自动注册一个账号再完成自动登录,返回token到前端。以实现微信小程序快速登录。
  • 现在无法通过解密encryptedData(wx.getUserProfile得到)获取用户的昵称、头像、性别、地区等数据,得提供一个类似“个人中心“的页面让用户自己完善(如果用户需要)。

springboot示例

配置在springboot配置文件中的参数:

//https://api.weixin.qq.com/sns/jscode2session
@Value("${wx.online_people_url}")
private String ONLINE_PEOPLE_URL;

//小程序的AppID
@Value("${wx.appId}")
private String APP_ID;

//小程序的AppSecret
@Value("${wx.appSecret}")
private String SECRET;

登录微信公众平台获取小程序的AppID、AppSecret

访问 auth.code2Session,使用 code 换取 openid、unionid、session_key 等信息:

/**
 * 微信登陆,通过code获取session_key
 * @param code 通过wx.login获取到的用户的code(登录凭证)
 * @return 返回session_key,用于解密 前端wx.getUserProfile接口 返回的加密的用户数据(2022-11,微信已弃用该接口,已无法通过其获取用户信息)。
 */
public DataVo<String> getSessionKey(String code) {
    //使用 hutool 解析json
    JSONObject json = JSONUtil.parseObj(getSessionKeyByWX(code));
    if(json.getBool("isSuccess")) {
        log.info("isSuccess = true,成功获取到session_key。session_key = "+json.getStr("session_key"));
        return JSONResult.ok(json.getStr("session_key"));
    }else {
        // 记录日志
        log.error("获取sessionkey失败! code = "+code);
        return JSONResult.errorMsg("获取sessionkey失败! code = "+code);
    }
}

/**
 * 微信登陆,通过code获取session_key、openid。
 *     session_key:用于解密 前端wx.getUserProfile(以前是wx.getUserInfo)接口 返回的加密的用户数据,头像、昵称、性别、地区等信息(2022-11,微信已弃用该接口,已无法通过其获取用户信息)。
 *     openid:用户的身份标识,每个用户在每个公众号或者小程序中都有一个唯一openid,跨公众号/小程序时openid不相同。若想在公众号、小程序、开放平台等地方使用不同账号,则使用openid作为用户标识。
 *
 * @param code 通过wx.login获取到的用户的code(登录凭证)
 * @return 返回session_key、openid、isSuccess,通过isSuccess是否为true来判断是否成功获取到session_key、openid。
 *         示例:{"session_key":"VtyIGnq9U2E8c95XUm2SeQ==","openid":"o60_YvksCvHRpajcmiLVAUYybXcM","isSuccess":"false"}
 */
public String getSessionKeyByWX(String code) {
    String baseUrl = ONLINE_PEOPLE_URL + "?appid=" + APP_ID + "&secret=" + SECRET + "&js_code=" + code + "&grant_type=authorization_code";
    log.info("---微信登陆,通过code获取sessionkey");
    log.info("---baseUrl ="+baseUrl);
    //使用 hutool 发起get请求
    //基于JDK的HttpUrlConnection封装
    String result = HttpUtil.get(baseUrl);
    log.info("---拿到GET结果 ="+result);
    //使用 hutool 解析json
    JSONObject jsonObject = JSONUtil.parseObj(result);
    if(!jsonObject.isNull("session_key")) {
        //成功获取到session_key等数据
        return result.substring(0,result.length()-1)+",\"isSuccess\":\"true\"}";
    }else {
        //失败,没获取到session_key等数据
        return "{\"session_key\":\"\",\"openid\":\"\",\"isSuccess\":\"false\"}";
    }
}

使用 session_key 解密encryptedData数据,获取用户信息(已废弃,encryptedData中没有用户数据):

/**
 * 微信登陆,解密encryptedData数据。
 *     但因为微信调整了用户信息权限,只能获取unionid,不能再获取头像、昵称、性别、地区等信息。
 *     unionid,微信用户的唯一标识(相当于微信用户ID),若想在公众号、小程序、开放平台等地方使用同一个账号,则使用unionid
 * @param encryptedData 被加密的数据
 * @param signature 加密秘钥(即getSessionKey方法返回的sessionKey)
 * @param iv 偏移量
 * @return 解密后的encryptedData(用户信息)
 */
public DataVo<String> getUserInfo(String encryptedData, String signature, String iv){
    // 被加密的数据
    byte[] dataByte = Base64.getDecoder().decode(encryptedData);
    // 加密秘钥
    byte[] keyByte = Base64.getDecoder().decode(signature);
    // 偏移量
    byte[] ivByte = Base64.getDecoder().decode(iv);

    log.error("被加密的数据 encryptedData= "+encryptedData);
    log.error("加密秘钥 sessionKey= "+signature);
    log.error("偏移量 iv= "+iv);

    //hutool AES解密
    AES aes = new AES("CBC","PKCS7Padding",keyByte,ivByte);
    String res = aes.decryptStr(dataByte);
    log.info("---解密后 ="+res);
    // 解密并返回
    return JSONResult.ok(res);
}

说明

本博客中的案例,使用的maven依赖如下:http请求、AES解密均使用的是hutool

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.5.2</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

<!--        启用web支持-->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!--        hutool-->
<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.10</version>
</dependency>



笔记摘自:CSDN-、楽.知乎-微信小程序获取用户unionId微信官方文档 • 小程序