微信小程序登录-蒲公英云

微信各接口定义（残缺版）：

package com.cong.security.core.properties;
public class WXConstant { 
    /** 获取access_token. */
    public static String GET_ACCESS_TOKEN_URL = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=%s&secret=%s";
    /** 根据openId获取用户信息 */
    public static String URL_GET_USER_INFO = "https://api.weixin.qq.com/sns/userinfo?openid=";
    /** 用oauth2获取用户信息. */
    public static String OAUTH2_USERINFO_URL = "https://api.weixin.qq.com/sns/userinfo?access_token=%s&openid=%s&lang=%s";
    /** 验证oauth2的access token是否有效. */
    public static String OAUTH2_VALIDATE_TOKEN_URL = "https://api.weixin.qq.com/sns/auth?access_token=%s&openid=%s";
    /** 微信小程序code换取openId接口 */
    public static String CODE_CHANGE_OPENID = "https://api.weixin.qq.com/sns/jscode2session?appid=%s&secret=%s&js_code=%s&grant_type=authorization_code";
    /** 微信小程序消息回复发送接口 */
    public static String SEND_MSG = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=";
}

微信小程序登录

返回值封装（code换取openId）

package com.cong.security.core.social.weixin.mini.connect;
import java.io.Serializable;
import lombok.Data;
import lombok.NoArgsConstructor;
@Data
@NoArgsConstructor
public class WxminiRes implements Serializable{ 
    private static final long serialVersionUID = 1L;
    private String openId;
    private String sessionKey;
    public WxminiRes(String openId, String sessionKey) { 
        super();
        this.openId = openId;
        this.sessionKey = sessionKey;
    }
}

微信小程序获取openID

package com.cong.security.core.social.weixin.mini.connect;
import java.security.Security;
import org.apache.commons.lang3.StringUtils;
import org.bouncycastle.jce.provider.BouncyCastleProvider;
import com.cong.security.core.code.CodeException;
import com.cong.security.core.properties.WXConstant;
import org.springframework.web.client.RestTemplate;
import com.alibaba.fastjson.JSONObject;
import lombok.extern.slf4j.Slf4j;
@Slf4j
public class WxMiniOauth2Template { 
    static { 
        // BouncyCastle是一个开源的加解密解决方案，主页在http://www.bouncycastle.org/
        Security.addProvider(new BouncyCastleProvider());
    }
    private String appId;
    private String appSecret;
    public WxMiniOauth2Template(String appId, String appSecret) { 
        super();
        this.appId = appId;
        this.appSecret = appSecret;
    }
    /** * 微信授权码获取openId * * @param code * 授权码 * @return 微信openId * @author single-聪 * @date 2020年7月30日 * @version 1.7.2 */
    public WxminiRes getOpenId(String code) { 
        RestTemplate restTemplate = new RestTemplate();
        String url = String.format(WXConstant.CODE_CHANGE_OPENID, this.appId, this.appSecret, code);
        String res = restTemplate.getForObject(url, String.class);
        log.info("微信小程序登录返回值为:[{}]", res);
        JSONObject data = JSONObject.parseObject(res);
        String openId = data.getString("openid");
        // 返回错误码时直接返回空
        if ((data.getString("errcode") == null || !"0".equals(data.getString("errcode")))
                && StringUtils.isNotBlank(openId)) { 
            // 额外的session_key字段
            return new WxminiRes(openId, data.getString("session_key"));
        } else { 
            throw new CodeException("登录失败");
        }
    }
}

根据前端传输的code换取微信小程序openId，CodeException为自定义异常，目的是为了异常捕获，自己定义一个即可。拿到用户openId即可实现登录。

用户信息解密

主要用于用户不存在时设置默认信息、此时需要用到获取openId是返回的session_key，所以上一步需要合理保存。

返回值封装

package com.cong.security.core.social.weixin.mini.connect;
import java.io.Serializable;
import lombok.Data;
import lombok.NoArgsConstructor;
@Data
@NoArgsConstructor
public class WeiXinMiniUserInfo implements Serializable{ 
    private static final long serialVersionUID = 1L;
    /** 用户唯一标识 */
    private String openId;
    /** 用户昵称 */
    private String nickName;
    /** 用户性别 */
    private String gender;
    /** 普通用户个人资料填写的城市 */
    private String city;
    /** 普通用户个人资料填写的省份 */
    private String province;
    /** 国家，如中国为CN */
    private String country;
    /** 用户头像，最后一个数值代表正方形头像大小（有0、46、64、96、132数值可选，0代表640*640正方形头像），用户没有头像时该项为空 */
    private String avatarUrl;
    /** 用户统一标识。针对一个微信开放平台帐号下的应用，同一用户的unionid是唯一的。 */
    private String unionId;
}

解密工具类

package com.cong.util;
import java.security.AlgorithmParameters;
import java.security.Security;
import java.util.Arrays;
import javax.crypto.Cipher;
import javax.crypto.spec.IvParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import org.apache.commons.codec.binary.Base64;
import org.bouncycastle.jce.provider.BouncyCastleProvider;
import com.cong.security.core.social.weixin.mini.connect.WeiXinMiniUserInfo;
import com.alibaba.fastjson.JSONObject;
import lombok.extern.slf4j.Slf4j;
@Slf4j
public class AesUtil { 
    static { 
        // BouncyCastle是一个开源的加解密解决方案，主页在http://www.bouncycastle.org/
        Security.addProvider(new BouncyCastleProvider());
    }
    public static WeiXinMiniUserInfo decrypt(String sessionKey, String encryptedData, String iv) { 
        // 被加密的数据
        byte[] dataByte = Base64.decodeBase64(encryptedData);
        // 加密秘钥
        byte[] keyByte = Base64.decodeBase64(sessionKey);
        // 偏移量
        byte[] ivByte = Base64.decodeBase64(iv);
        try { 
            // 如果密钥不足16位，那么就补足. 这个if 中的内容很重要
            int base = 16;
            if (keyByte.length % base != 0) { 
                int groups = keyByte.length / base + (keyByte.length % base != 0 ? 1 : 0);
                byte[] temp = new byte[groups * base];
                Arrays.fill(temp, (byte) 0);
                System.arraycopy(keyByte, 0, temp, 0, keyByte.length);
                keyByte = temp;
            }
            // 初始化
            Security.addProvider(new BouncyCastleProvider());
            Cipher cipher = Cipher.getInstance("AES/CBC/PKCS7Padding");
            SecretKeySpec spec = new SecretKeySpec(keyByte, "AES");
            AlgorithmParameters parameters = AlgorithmParameters.getInstance("AES");
            parameters.init(new IvParameterSpec(ivByte));
            cipher.init(Cipher.DECRYPT_MODE, spec, parameters);// 初始化
            byte[] resultByte = cipher.doFinal(dataByte);
            if (null != resultByte && resultByte.length > 0) { 
                String result = new String(resultByte, "UTF-8");
                log.info("解析出用户数据为:[{}]", result);
                WeiXinMiniUserInfo userInfo = JSONObject.parseObject(result, WeiXinMiniUserInfo.class);
                return userInfo;
            }
        } catch (Exception e) { 
            log.info("微信小程序数据解析异常:[{}]", e.getMessage());
        }
        return null;
    }
}

解密所需参数

获取用户信息

参数	解释	获取
encryptedData	包括敏感数据在内的完整用户信息的加密数据	wx.getUserInfo(Object object)
iv	加密算法的初始向量	wx.getUserInfo(Object object)
session_key	会话密钥	code换取openId时返回

注意：可以在上一个接口中返回session_key，但是小程序官网不建议将session_key返回给前端、所以后端需要存储并且在两次接口请求中能够辨别是同一个用户，从而获取到正确的session_key，获取到正确的session_key有有效期、好像只可以使用一次而且只有最新的有效！！！所以前端的login和getUserInfo接口调用有顺序而且有次数规则。（本文为Java后端开发，前端调用简单介绍）

附

因为是第三方登录，所有有两种情况需要考虑：

用户已注册：此时小程序用户信息解密失败也是没什么问题，毕竟不会使用这个数据覆盖自己系统中的用户信息
用户未注册：此时需要考虑用户信息解密失败的情况，为了良好的用户体验，即使解密失败（可能由于网络等原因解密失败、前一步code2session验证通过实际上这个用户基本上就是真实用户了）也应该设置默认值而不是提示用户注册失败

本文使用的登录是基于Oauth2协议使用JWT生成令牌，不同项目代码嵌入方式不同，所以只封装了和微信那边的对接，至于在自己代码中的业务逻辑自行编写即可。

对接有几天了，可能部分代码会缺失，如有缺失请留言。