微信小程序登录的后端Java详细实现

这几天帮朋友实现微信小程序的后端接口，在登录功能这块卡了一下，在查阅资料后成功实现，下面做个详细总结。

 

步骤

1.在微信公众平台（https://mp.weixin.qq.com/）注册小程序开发账号。

2.在小程序开发平台上获取AppId和AppSecret（在“开发->开发设置”中获取）。

3.捋清微信小程序登录流程，参考微信App开放文档（https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html）。

4.新建一个微信实体类（WeChatModel），用来获取前端传过来的参数。

5.新建一个微信session实体类（WeChatSessionModel），用来获取微信服务器传过来的参数。

6.实现具体代码

 

详情

1.2均略

3.微信小程序登录流程

整个登录流程有三个参与者：前端、后端、微信端。

前端分别调用微信端的wx.login()方法及后端的自定义接口(/login)；后端在login接口中调用微信端的auth.code2Session()

a.前端调用微信服务器的wx.login()方法得到微信用户信息

b.前端调用后端接口(/login)，将用户参数传递给后端（code为必传项）

c.后端根据前端传递的用户参数调用微信服务器的auth.code2Session()方法得到用户的唯一id（openid），并将用户信息及openid储存至后端数据库

d.后端返回前端“登录成功”

4.WeChatModel类

package com.pp.ppgraduate.entity;

public class WeChatModel {
    private String code;
    private String avatarUrl;
    private String nickName;
    private String openId;

    public String getCode() {
        return code;
    }

    public void setCode(String code) {
        this.code = code;
    }

    public String getAvatarUrl() {
        return avatarUrl;
    }

    public void setAvatarUrl(String avatarUrl) {
        this.avatarUrl = avatarUrl;
    }

    public String getNickName() {
        return nickName;
    }

    public void setNickName(String nickName) {
        this.nickName = nickName;
    }

    public String getOpenId() {
        return openId;
    }

    public void setOpenId(String openId) {
        this.openId = openId;
    }
}

5.WeChatSessionModel类

package com.pp.ppgraduate.entity;

public class WeChatSessionModel {
    private String openid;
    private String session_key;
    private String errcode;
    private String errmsg;

    public String getOpenid() {
        return openid;
    }

    public void setOpenid(String openid) {
        this.openid = openid;
    }

    public String getSession_key() {
        return session_key;
    }

    public void setSession_key(String session_key) {
        this.session_key = session_key;
    }

    public String getErrcode() {
        return errcode;
    }

    public void setErrcode(String errcode) {
        this.errcode = errcode;
    }

    public String getErrmsg() {
        return errmsg;
    }

    public void setErrmsg(String errmsg) {
        this.errmsg = errmsg;
    }
}

6.Controller类

//在开发者平台中获取APPID和APPSECRET
private static final String APPID= "****************";
private static final String APPSECRET = "****************";

@PostMapping("/login")
    @ResponseBody
    public Result login(@RequestBody WeChatModel weChatModel){
        String openid = null;
        String session_key = null;
        String errcode = null;
        String errmsg = null;
        WeChatSessionModel weChatSessionModel;

        //微信服务器的接口路径
        String url = "https://api.weixin.qq.com/sns/jscode2session?appid="+APPID+ "&secret="+APPSECRET+"&js_code="+ weChatModel.getCode() +"&grant_type=authorization_code";
        RestTemplate restTemplate = new RestTemplate();
        //进行网络请求,访问微信服务器接口
        ResponseEntity<String> responseEntity = restTemplate.exchange(url, HttpMethod.GET, null, String.class);
        //根据返回值进行后续操作

        if(responseEntity != null && responseEntity.getStatusCode() == HttpStatus.OK) {
            String sessionData = responseEntity.getBody();
            Gson gson = new Gson();
            //将json字符串转化为实体类;
            weChatSessionModel = gson.fromJson(sessionData, WeChatSession.class);
            //获取用户的唯一标识
            openid = weChatSessionModel.getOpenid();
            //获取会话秘钥（具有时效性，用户登录的临时通行证）
            //登录后前端的每次接口请求都需带上session_key
            session_key = weChatSessionModel.getSession_key();
            //获取错误码
            errcode = weChatSessionModel.getErrcode();
            //获取错误信息
            errmsg = weChatSessionModel.getErrmsg();
        }
        try{
            if (openid == null || session_key == null){
                return Result.error("errcode: " + errcode + ";errmsg: " + errmsg);
            }
            UserModel user = userService.login(openid);
            if(EmptyUtil.isEmpty(user)){
                weChatModel.setOpenId(openid);
                boolean flag = userService.insertUser(weChatModel);
                if(flag == true){
                    return Result.success(weChatModel);
                }
                else {
                    return Result.error("用户login失败！");
                }
            }
            else{
                return Result.success(user);
            }
        } catch (MyException e) {
            return Result.error(e.getCode(), e.getMessage());
        } catch (Exception e) {
            logger.error(e.getMessage(), e);
            e.printStackTrace();
            return Result.error(ResultEnum.UNKONW_ERROR.getCode(), "添加用户信息Exception");
        }
    }

其中UserModel为用户信息类，userService为用户service接口类，Result、ResultEnum、MyException、EmptyUtil为自定义的工具类，可按需要自行编写。

参考链接：https://blog.csdn.net/qq_35219282/article/details/85136401