java后端接入微信小程序登录功能

前言

此文章是Java后端接入微信登录功能，由于项目需要，舍弃了解密用户信息的session_key，只保留openid用于检索用户信息
后端框架：spring boot
小程序框架：uniapp
流程概括

• 官方流程：通过自定义登录态与openid，session_key关联，之后的前后端交互通过自定义登录态来识别
  
• 只保留登录流程：使用 spring boot 的session进行交互，openid存入数据库，用来检索用户信息（可以理解为 openid 作为账号，只保留此小程序的登录功能）
  

官方小程序登录流程图解（图取自官网）

• 通过wx.login()获取code
  
• 将code发送给后端服务器，后端会返回一个token，这个token将作为你身份的唯一标识。
  
• 将token通过wx.setStorageSync()保存在本地存储。
  
• 用户下次进入⻚面时，会先通过wx.getStorageSync() 方法判断token是否有值，如果有值，则可以请求其它数据，如果没有值，则进行登录操作。
  

• openid：用来唯一标识用户的一个字符串，通过openid可以获取用户的基本信息（不同小程序中拥有不同openid）
  
• code：code是用户登录凭证，由微信服务器颁发给小程序；后端通过code向微信服务器请求用户的openid和session_key等信息。（code是一次性的，且时效为5分钟）
  
• unionid：用于标识同一微信开放平台账号下多个应用的用户，多个小程序中的unionid是相同的
  

接入小程序登录（只保留 openid 登录功能）

• 通过wx.login()获取code
  
• 将code发送给后端服务器，后端保存openid到数据库并返回sessionId
  
• 将sessionId通过wx.setStorageSync()保存在本地存储
  
• 用户下次进入⻚面时，会先通过wx.getStorageSync() 方法判断sessionId是否有值，如果有值，则可以请求其它数据，如果没有值，则进行登录操作。
  

后端代码

工具类

1. import cn.hutool.core.util.StrUtil;
2. import cn.hutool.http.HttpRequest;
3. import cn.hutool.json.JSONObject;
4. import com.redapple.project.common.ErrorCode;
5. import com.redapple.project.exception.ThrowUtils;
7. public class RequestUtils {
9.     // 获取AccessToken
10.     public static JSONObject getAccessToken(String appId, String appSecret) {
11.         String apiUrl = StrUtil.format(
12.                 "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={}&secret={}",
13.                 appId, appSecret
14.         );
15.         String body = HttpRequest.get(apiUrl).execute().body();
16.         ThrowUtils.throwIf(body == null, ErrorCode.OPERATION_ERROR);
17.         return new JSONObject(body);
18.     }
20.     // 获取session_key和openid
21.     public static String getOpenIdByCode(String appId, String secret, String code) {
22.         String apiUrl = StrUtil.format(
23.                 "https://api.weixin.qq.com/sns/jscode2session?appid={}&secret={}&js_code={}&grant_type=authorization_code",
24.                 appId, secret, code
25.         );
26.         String body = HttpRequest.get(apiUrl).execute().body();
27.         ThrowUtils.throwIf(body == null, ErrorCode.OPERATION_ERROR);
28.         return body;
29.     }
31. }

复制代码

登录实现

主要接收三个参数，分别是小程序的appi、appSecret、前端传来的code
这里通过工具类向微信接口服务发送jscode，返回openid

• openid存在：登录，返回用户信息
  
• openid不存在：注册，将openid存入数据库并返回用户信息
  

1.     public LoginUserVO WeChatLogin(String appid, String secret, String code, HttpServletRequest request) {
2.         // 获取session_key和openid
3.         String result = RequestUtils.getOpenIdByCode(appid, secret, code);
4.         System.out.println("result:" + result);
5.         // 提取openid
6.         String openid = new JSONObject(result).getStr("openid");
7.         // 这里是自己封装的方法，流程是如果openid为空则抛异常
8.         ThrowUtils.throwIf(openid == null, ErrorCode.NOT_FOUND_ERROR, "openid为空");
9.         // 查询openid是否存在
10.         QueryWrapper<User> queryWrapper = new QueryWrapper<>();
11.         queryWrapper.eq("openid", openid);
12.         User oldUser = this.baseMapper.selectOne(queryWrapper);
13.         // openid不存在
14.         if (oldUser == null) {
15.             // 添加用户
16.             User user = new User();
17.             user.setOpenid(openid);
18.             user.setPhone("手机号未填写");
19.             user.setUserName("默认用户");
20.             boolean saveResult = this.save(user);
21.             if (!saveResult) {
22.                 // 这里也是自己封装的方法，流程是抛自定义异常
23.                 throw new BusinessException(ErrorCode.SYSTEM_ERROR, "注册失败，数据库错误");
24.             }
25.             // 记录用户的登录态
26.             request.getSession().setAttribute(USER_LOGIN_STATE, user);
27.             return getLoginUserVO(user);
28.         }
29.         // 记录用户的登录态
30.         request.getSession().setAttribute(USER_LOGIN_STATE, oldUser);
31.         // 用户存在，返回用户数据
32.         return getLoginUserVO(oldUser);        // 自己封装的方法，返回脱敏的用户数据
33.     }

复制代码

前端代码

uniapp框架

1. <template>
2.         <view>
3.                 <button  @click="login">微信一键登录</button>
4.         </view>
5. </template>

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！