SpringCloud Alibaba 开发微信公众号 （网页授权获取用户基本信息）

持续创作，加速成长！这是我参与「掘金日新计划 · 10 月更文挑战」的第11天，点击查看活动详情

上一篇讲了模板消息管理，这一篇讲网页授权获取用户基本信息。

场景：

用户在微信客户端中访问第三方网页，公众号可以通过微信网页授权机制，来获取用户基本信息，进而实现业务逻辑。

网页授权流程分为四步：

1.  引导用户进入授权页面同意授权，获取code
1.  通过 code 换取网页授权access_token（与基础支持中的access_token不同）
1.  如果需要，开发者可以刷新网页授权access_token，避免过期
1.  通过网页授权access_token和 openid 获取用户基本信息（支持 UnionID 机制）

1 第一步：用户同意授权，获取code

首先需要引导用户点击授权链接，如果用户同意授权就可以拿到用户的code，进行下一步。

1.1 微信常量类新增设置引导链接URL OAUTH2_AUTHORIZE （）

 /**
 * 引导链接
 */
    public static final String OAUTH2_AUTHORIZE = "https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect";

参数说明：

appid： 公众号的唯一标识

redirect_uri： 授权后重定向的回调链接地址， 请使用 urlEncode 对链接进行处理 （设置方式如图：

注意： 这块有个细节，如果设置错了1.2步骤回调时就汇报（10003 redirect_uri域名与后台配置不一致 ），一定是域名不要带着http:// 等协议头。见官文

response_type： 返回类型，请填写code

scope： 我们使用snsapi_userinfo （弹出授权页面，可通过 openid 拿到昵称、性别、所在地。并且， 即使在未关注的情况下，只要用户授权，也能获取其信息 ）

state： 重定向后会带上 state 参数，开发者可以填写a-zA-Z0-9的参数值，最多128字节

#wechat_redirect： 无论直接打开还是做页面302重定向时候，必须带此参数

1.2 修改文本消息处理类 TextMessageService

我们修改文本消息处理类，设置当用户文本为“授权登录”时，展示用户登录链接，用户点击链接则获取到用户的code

private final WeCharConfig weCharConfig;

public TextMessageService(WeCharConfig weCharConfig) {
    this.weCharConfig = weCharConfig;
}


@Override
public String handler(Map<String, Object> param) {
    String content = "你好呀，欢迎关注我的测试公众号！！";
    if (param.get(WeCharConstant.CONTENT).toString().equals("授权登录")) {
        content = WeCharConstant.OAUTH2_AUTHORIZE.replace("APPID", weCharConfig.getAppId())
                .replace("REDIRECT_URI", "https://6016a95m81.zicp.fun/v1/weChar/getCode").replace("SCOPE", "snsapi_userinfo");
        System.out.println(content);
        content = "您好，请点击<a href='" + content + "'>授权登录</a>进行更多的操作。";
    }

    return  TextMessage.ofSendMsg(param, content).toXml();
}

1.3 增加回调处理类 UserInfoController

import cn.org.spring.common.util.HttpClientUtils;
import com.alibaba.fastjson.JSON;
import com.ctsi.sddx.config.WeCharConfig;
import com.ctsi.sddx.constants.WeCharConstant;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import java.io.IOException;

/**
 * @Author : lizzu
 * @create 2022/10/5 16:05
 */
@Slf4j
@RestController
@RequestMapping("/v1/weChar")
public class UserInfoController {


    @Autowired
    private WeCharConfig charConfig;

    /**
     * 回调链接
     * 1、获取code -> 获取accessToken ->获取用户基本信息
     */
    @RequestMapping("/getCode")
    public String getCode(@RequestParam("code") String code,
                          @RequestParam("state") String state)  {
        System.out.println(code);
        System.out.println(state);
        return code+"----"+state;
    }
 }

1.4 测试

成功取到用户code 后台输出

2 第二步：通过 code 换取网页授权access_token

2.1 微信常量类新增获取OAUTH认证的access_token URL OAUTH_GET_AT

/**
 * 获取OAUTH认证的access_token
 */
public static final String OAUTH_GET_AT = "https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code";

2.2 修改 UserInfoController 回调方法getCode() ，增加获取accessToken 和 openID 方法getAccessToken(String code)

  @Autowired
    private WeCharConfig charConfig;

    /**
     * 回调链接
     * 1、获取code -> 获取accessToken ->获取用户基本信息
     */
    @RequestMapping("/getCode")
    public String getCode(@RequestParam("code") String code,
                          @RequestParam("state") String state) throws IOException {
        System.out.println(code);
        System.out.println(state);

        String userInfo = getAccessToken(code);

        return userInfo;
    }

    /**
     * 获取accessToken 和 openID
     *
     * @param code
     * @return
     * @throws IOException
     */
    public String getAccessToken(String code) throws IOException {
        String s = HttpClientUtils.get(WeCharConstant.OAUTH_GET_AT.replace("APPID", charConfig.getAppId())
                .replace("SECRET", charConfig.getSecret()).replace("CODE", code));
        System.out.println("获取access token " + s);
        String access_token = JSON.parseObject(s).getString("access_token");
        String openid = JSON.parseObject(s).getString("openid");

        return "access_token:"+access_token+" openid:"+openid;
    }

2.3 测试:

获取access token {"access_token":"61_ZumbIGiicy0Efksa3Ru5doVykU-qWCqFRf8EbWh8nHEstNhq6qV-5YRnc38X8Zf4gjyIY3BblJ0MVaTLW68MoB75UuKPp7S-cFa9omcgm7M","expires_in":7200,"refresh_token":"61_Y62Fo2Bdxp3U0fYkgPjTFMBNqU1073xikXko8eYq904qVUPiJfj3UmxJt76u4aEib1HfQLUmBdxrBUVigxK5Sa5xTvc8-j7VBrELaxfhLdM","openid":"oITpR58LM-HJG0Fa4BY6MkOCG5lM","scope":"snsapi_userinfo"}

格式化：
{
	"access_token": "61_ZumbIGiicy0Efksa3Ru5doVykU-qWCqFRf8EbWh8nHEstNhq6qV-5YRnc38X8Zf4gjyIY3BblJ0MVaTLW68MoB75UuKPp7S-cFa9omcgm7M",
	"expires_in": 7200,
	"refresh_token": "61_Y62Fo2Bdxp3U0fYkgPjTFMBNqU1073xikXko8eYq904qVUPiJfj3UmxJt76u4aEib1HfQLUmBdxrBUVigxK5Sa5xTvc8-j7VBrELaxfhLdM",
	"openid": "oITpR58LM-HJG0Fa4BY6MkOCG5lM",
	"scope": "snsapi_userinfo"
}

可以看到已经拿到了access_token，有效期expires_in、刷新token refresh_token 等。

3 第三步：刷新access_token（如果需要）

如果超时，即可使用

**请求方法**

> 获取第二步的refresh_token后，请求以下链接获取access_token：

> https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=APPID&grant_type=refresh_token&refresh_token=REFRESH_TOKEN

4 第四步：拉取用户信息(需 scope 为 snsapi_userinfo)

4.1微信常量类新增获取用户基本信息 URL OAUTH_USER_INFO

/**
 * 获取用户基本信息
 */
public static final String OAUTH_USER_INFO = "https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN";

4.2修改 UserInfoController 增加获取用户基本信息方法 getUserInfo

/**
 * 获取用户基本信息
 *
 * @param accessToken
 * @param openId
 * @return
 * @throws IOException
 */
public String getUserInfo(String accessToken, String openId) throws IOException {
    return HttpClientUtils.get(WeCharConstant.OAUTH_USER_INFO.replace("ACCESS_TOKEN", accessToken).replace("OPENID", openId));
}

4.3测试

格式化数据
{
	"openid": "oITpR58LM-HJG0Fa4BY6MkOCG5AA",
	"nickname": "? 奇了怪了怪",
	"sex": 0,
	"language": "",
	"city": "",
	"province": "",
	"country": "",
	"headimgurl": "https://thirdwx.qlogo.cn/mmopen/vi_32/DYAIOgq83eoNc4aUZJT2w05SMIqFLQLxofkjuADnj3icyeIiaNDVlxKbFfkQRDchfwYI3FQTdxPu0NDGBSBUzVqg/135",
	"privilege": []
}

5 附：检验授权凭证（access_token）是否有效

5.1 微信常量类新增获取用户基本信息 URL OAUTH_USER_INFO

/**
 * 获取用户基本信息
 */
public static final String CHECK_USER_INFO = "https://api.weixin.qq.com/sns/auth?access_token=ACCESS_TOKEN&openid=OPENID";

5.2 UserInfoController 新增检验授权凭证（access_token）是否有效方法 checkAccessToken(String accessToken, String openId)

完整UserInfoController

import cn.org.spring.common.util.HttpClientUtils;
import com.alibaba.fastjson.JSON;
import com.ctsi.sddx.config.WeCharConfig;
import com.ctsi.sddx.constants.WeCharConstant;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import java.io.IOException;

/**
 * @Author : lizzu
 * @create 2022/10/5 16:05
 */
@Slf4j
@RestController
@RequestMapping("/v1/weChar")
public class UserInfoController {


    @Autowired
    private WeCharConfig charConfig;

    /**
     * 回调链接
     * 1、获取code -> 获取accessToken ->获取用户基本信息
     */
    @RequestMapping("/getCode")
    public String getCode(@RequestParam("code") String code,
                          @RequestParam("state") String state) throws IOException {
        System.out.println(code);
        System.out.println(state);

        String userInfo = getAccessToken(code);

        log.info("获取用户的基本信息 【{}】", userInfo);

        return userInfo;
    }

    /**
     * 获取accessToken 和 openID
     *
     * @param code
     * @return
     * @throws IOException
     */
    public String getAccessToken(String code) throws IOException {
        String s = HttpClientUtils.get(WeCharConstant.OAUTH_GET_AT.replace("APPID", charConfig.getAppId())
                .replace("SECRET", charConfig.getSecret()).replace("CODE", code));
        System.out.println("获取access token " + s);
        String access_token = JSON.parseObject(s).getString("access_token");
        String openid = JSON.parseObject(s).getString("openid");
        checkAccessToken(access_token, openid);//检验授权凭证（access_token）是否有效
        return getUserInfo(access_token, openid);
    }

    /**
     * 获取用户基本信息
     *
     * @param accessToken
     * @param openId
     * @return
     * @throws IOException
     */
    public String getUserInfo(String accessToken, String openId) throws IOException {
        return HttpClientUtils.get(WeCharConstant.OAUTH_USER_INFO.replace("ACCESS_TOKEN", accessToken).replace("OPENID", openId));
    }

    /**
     * 检验授权凭证（access_token）是否有效
     *
     * @param accessToken
     * @param openId
     * @return
     * @throws IOException
     */
    public String checkAccessToken(String accessToken, String openId) throws IOException {
        String s = HttpClientUtils.get(WeCharConstant.CHECK_USER_INFO.replace("ACCESS_TOKEN", accessToken).replace("OPENID", openId));
        String errmsg = JSON.parseObject(s).getString("errmsg");
        log.info("校验结果： 【{}】", errmsg);
        return s;
    }
}

5.3测试：

至此网页授权获取用户基本信息相关接口的代码实现已完成

下一篇： 本想着找个实战的结果没找到....就先欠着下一篇写小程序的吧。