1、项目介绍
2、微信公众平台 和 微信开放文档
2.1 微信公众平台
2.1.1 网址链接
https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index
2.1.2 测试号信息
2.1.3 微信扫描关注测试公众号
2.1.4 授权回调页面域名
2.1.4.1 网页服务->网页账号->修改
2.1.4.2 填写 授权回调页面域名
2.1.4.3 内网穿透 NATAPP
2.1.4.3.1 使用教程
- NATAPP1分钟快速新手图文教程: https://natapp.cn/article/natapp_newbie
- 下载: https://natapp.cn/#download
- 使用本地配置文件config.ini: https://natapp.cn/article/config_ini
复制代码 2.1.4.3.2 authtoken
2.1.4.3.3 授权回调页面域名
2.2 微信开放文档
2.2.1 网址链接
https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html#2
2.2.2 官方 基本步骤教程
1 第一步:用户同意授权,获取code
2 第二步:通过 code 换取网页授权access_token
3 第三步:刷新access_token(如果需要)
4 第四步:拉取用户信息(需 scope 为 snsapi_userinfo)
5 附:检验授权凭证(access_token)是否有效
3、http请求工具类 HttpClient4Util
HttpClient4Util 用来发http请求;
https://www.cnblogs.com/xiaoqigui/p/16839536.html
4、配置文件 和 配置类
4.1 配置文件
application.yml- #端口
- server:
- port: 8096
- # 自定义微信授权信息
- wechat:
- auth:
- app-id: wxd4e20add67****** # appID
- app-secret: a21e97d21d0d6ce408b7a6c****** # appsecret
- code-uri: https://open.weixin.qq.com/connect/oauth2/authorize # 请求微信官方获取用户授权code 的请求地址
- redirect-uri: http://******.natappfree.cc/wechat/auth/codeBack # 微信官方返回 用户授权code 的回调地址
- access-token-uri: https://api.weixin.qq.com/sns/oauth2/access_token # 根据微信回调的code值,请求微信官方获取用户access_token 的请求地址
- user-info-uri: https://api.weixin.qq.com/sns/userinfo #根据用户的 accessToken 和 openId 拉取用户信息 的请求地址
复制代码 4.2 配置类
- //自定义微信授权参数信息配置类
- @Data
- @Component
- @ConfigurationProperties(prefix = "wechat.auth")
- public class WeChatAuthConfig {
- /*
- 应用id
- */
- private String appId;
- /*
- 应用密钥
- */
- private String appSecret;
- /*
- 请求获取code的地址
- */
- private String codeUri;
- /*
- 微信官方回调code的地址
- */
- private String redirectUri;
- /**
- * 微信官方获取access_token地址
- */
- private String accessTokenUri;
- /*
- 微信官方获取userInfo地址
- */
- private String userInfoUri;
- }
复制代码 5、server 层
5.1 微信授权的业务接口
- /**
- * Created On : 28/10/2022.
- * <p>
- * Author : huayu
- * <p>
- * Description: 微信授权的业务接口
- */
- public interface WeChatAuthService {
- //生成请求微信官方获取用户授权code的请求地址
-
- //根据微信回调的code值,请求微信官方获取用户access_token
-
- //根据用户的 accessToken 和 openId 拉取用户信息
- }
复制代码 5.1.1 生成请求微信官方获取用户授权code的请求地址
- /**
- * @author : huayu
- * @date : 28/10/2022
- * @param : []
- * @return : java.lang.String
- * @description : 生成请求微信官方获取用户授权code的请求地址
- */
- String generateWeChatAuthCodeUrl();
复制代码 5.1.2 根据微信回调的code值,请求微信官方获取用户access_token
- /**
- * @author : huayu
- * @date : 28/10/2022
- * @param : [wechatAuthCode]
- * @return : java.lang.String
- * @description : 根据微信回调的code值,请求微信官方获取用户access_token
- */
- String getAccessTokenFromWechatUseCode(String wechatAuthCode);
复制代码 5.1.3 根据用户的 accessToken 和 openId 拉取用户信息
- /**
- * @author : huayu
- * @date : 28/10/2022
- * @param : [accessToken, openId]
- * @return : java.lang.String
- * @description : 根据用户的 accessToken 和 openId 拉取用户信息
- */
- String getUserInfoFromWechatUseAccessToken(String accessToken,String openId);
复制代码 5.2 微信授权的业务接口 实现类
- /**
- * Created On : 28/10/2022.
- * <p>
- * Author : huayu
- * <p>
- * Description: 微信授权的业务接口 实现类
- */
- @Service
- @Slf4j
- public class WeChatAuthServiceImpl implements WeChatAuthService{
- //注入 http请求工具类
- @Autowired
- private WeChatAuthConfig weChatAuthConfig;
-
- //生成请求微信官方获取用户授权code的请求地址
-
- //根据微信回调的code值,请求微信官方获取用户access_token
-
- //根据用户的 accessToken 和 openId 拉取用户信息
- }
复制代码 5.2.1 生成请求微信官方获取用户授权code的请求地址
- /**
- * @author : huayu
- * @date : 29/10/2022
- * @param : []
- * @return : java.lang.String
- * @description : 生成请求微信官方获取用户授权code的请求地址
- */
- @Override
- public String generateWeChatAuthCodeUrl() {
- //微信官方引导用户打开授权页面,获取code的完整路径
- //https://open.weixin.qq.com/connect/oauth2/authorize
- // ?appid=APPID
- // &redirect_uri=REDIRECT_URI
- // &response_type=code
- // &scope=SCOPE
- // &state=STATE
- // #wechat_redirect
- //尤其注意:由于授权操作安全等级较高,所以在发起授权请求时,微信会对授权链接做正则强匹配校验,如果链接的参数顺序不对,授权页面将无法正常访问
- //生成请求卫星官方获取用户code的完整地址
- StringBuilder weCharAuthCodeUrl = new StringBuilder(weChatAuthConfig.getCodeUri());
- weCharAuthCodeUrl.append("?appid=").append(weChatAuthConfig.getAppId())
- .append("&redirect_uri=").append(weChatAuthConfig.getRedirectUri())
- .append("&response_type=code")
- //&scope=snsapi_userinfo&state=STATE
- .append("&scope=").append("snsapi_userinfo")
- .append("&state=").append("kh96_wechat_auth")
- .append("#wechat_redirect");
- log.info("------ 请求微信官方授权网站地址:{} ------",weCharAuthCodeUrl.toString());
- //返货完整的请求地址
- return weCharAuthCodeUrl.toString();
- }
复制代码 5.2.2 根据微信回调的code值,请求微信官方获取用户access_token
- /**
- * @author : huayu
- * @date : 29/10/2022
- * @param : [wechatAuthCode]
- * @return : java.lang.String
- * @description : 根据微信回调的code值,请求微信官方获取用户access_token
- */
- @Override
- public String getAccessTokenFromWechatUseCode(String wechatAuthCode) {
- // 尤其注意:由于公众号的 secret 和获取到的access_token安全级别都非常高,必须只保存在服务器,不允许传给客户端。
- // 请求方法:获取 code 后,请求以下链接获取access_token:
- // https://api.weixin.qq.com/sns/oauth2/access_token
- // ?appid=APPID
- // &secret=SECRET
- // &code=CODE
- // &grant_type=authorization_code
- // 封装根据code,请求微信官方获取access_token的完整地址
- StringBuilder accessTokenUrl = new StringBuilder(weChatAuthConfig.getAccessTokenUri());
- accessTokenUrl.append("?appid=").append(weChatAuthConfig.getAppId())
- .append("&secret=").append(weChatAuthConfig.getAppSecret())
- .append("&code=").append(wechatAuthCode)
- .append("&grant_type=authorization_code");
- log.info("------ 根据code,请求微信官方获取access_token的完整地址:{} ------", accessTokenUrl.toString());
- // 根据code,请求微信官方获取access_token,返回结果是同步返回的,不再是异步回调
- // 请求是服务器内部发起的,也就是说:在程序中,要根据上面完整的请求地址,主动发送请求到微信官方,接口同步会返回一个json格式的字符串结果,程序内要解析获取的结果
- // 程序内主动发起http请求,获取access_token
- return HttpClient4Util.getResponse4GetAsString(accessTokenUrl.toString(), "utf-8");
- }
复制代码 5.2.3 根据用户的 accessToken 和 openId 拉取用户信息
- /**
- * @author : huayu
- * @date : 29/10/2022
- * @param : [accessToken, openId]
- * @return : java.lang.String
- * @description : 根据用户的 accessToken 和 openId 拉取用户信息
- */
- @Override
- public String getUserInfoFromWechatUseAccessToken(String accessToken, String openId) {
- // 如果网页授权作用域为snsapi_userinfo,则此时开发者可以通过access_token和 openid 拉取用户信息了。
- // http:GET(请使用 https 协议):
- // https://api.weixin.qq.com/sns/userinfo
- // ?access_token=ACCESS_TOKEN
- // &openid=OPENID
- // &lang=zh_CN
- // 封装根据accessToken和openId,请求微信官方获取用户信息详情地址
- StringBuilder userInfoUrl = new StringBuilder(weChatAuthConfig.getUserInfoUri());
- userInfoUrl.append("?access_token=").append(accessToken)
- .append("&openid=").append(openId)
- .append("&lang=zh_CN");
- log.info("------ 根据access_token,请求微信官方获取userinfo的完整地址:{} ------", userInfoUrl.toString());
- // 程序内主动发起http请求,获取用户详情
- return HttpClient4Util.getResponse4GetAsString(userInfoUrl.toString(), "utf-8");
- }
复制代码 6、controller 层
- /**
- * Created On : 28/10/2022.
- * <p>
- * Author : huayu
- * <p>
- * Description: 测试微信授权登录操作入口
- */
- //@SuppressWarnings("all")
- @Slf4j
- @RestController
- @RequestMapping("/wechat/auth")
- public class WeChatAuthController {
- //注入service层实现类
- @Autowired
- private WeChatAuthService weChatAuthService;
- }
复制代码 6.1 获取请求微信官方货物code的完整地址,用户访问该地址
- /**
- * @author : huayu
- * @date : 28/10/2022
- * @param : []
- * @return : com.kgc.scd.uitl.RequestResult<java.lang.String>
- * @description : 获取请求微信官方货物code的完整地址,用户访问该地址,可以进行授权操作(把地址交给前端生成二维码给用户扫码,或者后端生成)
- */
- @GetMapping("/codeUrl")
- public RequestResult<String> codeUrl(){
- //调用业务接口,获取完整用户授权访问的地址
- return ResultBuildUtil.success(weChatAuthService.generateWeChatAuthCodeUrl());
- }
复制代码 6.2 获取用户详情信息
- 用户授权后,接收微信官方异步回调请求,获取用户授权的code:(code,state)
- 1.通过 code 换取网页授权access_token
- 2.拉取用户信息(需 scope 为 snsapi_userinfo)
- 3.接口返回用户详情信息
复制代码- /**
- * @author : huayu
- * @date : 28/10/2022
- * @param : []
- * @return : com.kgc.scd.uitl.RequestResult<java.util.Map<java.lang.String,java.lang.Object>>
- * @description : 接收微信官方异步回调请求,获取用户授权的code
- * 流程:用户先根据上一步返回请求地址,进行授权操作,如果用户统一授权,微信官方自动根据上一步请求带过去的回调地址redirectUri,进行结果回调
- */
- @RequestMapping("/codeBack")
- public RequestResult<Map<String, Object>> codeBack(HttpServletRequest request){
- // 用户同意授权后,如果用户同意授权,页面将跳转至 redirect_uri/?code=CODE&state=STATE。
- // code说明:code作为换取access_token的票据,每次用户授权带上的 code 将不一样,code只能使用一次,5分钟未被使用自动过期。
- // 从官方回调的请求中,获取用户授权后的code参数值
- String wechatAuthCode = request.getParameter("code");
- // 从官方回调的请求中,获取用户授权时的自定义参数state
- String wechatAuthState = request.getParameter("state");
- log.info("------ 微信授权后,官方异步回调结果:code={},state={} ------", wechatAuthCode, wechatAuthState);
- // 定义接口返回集合对象
- Map<String, Object> resultMap = new HashMap<>();
- // 参数非空校验
- if(StringUtils.isBlank(wechatAuthCode)){
- resultMap.put("msg", "授权code为空!");
- return ResultBuildUtil.fail(resultMap);
- }
- // 1. 调用业务接口,通过 code 换取网页授权access_token
- String accessTokenJson = weChatAuthService.getAccessTokenFromWechatUseCode(wechatAuthCode);
- log.info("------ 通过 code 换取网页授权access_token返回结果:{} ------", accessTokenJson);
- // 正确时返回的 JSON 数据包如下:
- // {"access_token":"ACCESS_TOKEN","expires_in":7200,"refresh_token":"REFRESH_TOKEN","openid":"OPENID","scope":"SCOPE"}
- // 错误时返回的 JSON 数据包如下:
- // {"errcode":40029,"errmsg":"invalid code"}
- // 解析返回的json数据
- JSONObject accessTokenJsonObj = JSON.parseObject(accessTokenJson);
- // 判断获取access_token结果是否正确,如果错误,直接结束,如果正确,获取对应的access_token
- if(StringUtils.isNotBlank(accessTokenJsonObj.getString("errcode"))){
- resultMap.put("wxCode", accessTokenJsonObj.getString("errcode"));
- resultMap.put("wxMsg", accessTokenJsonObj.getString("errmsg"));
- return ResultBuildUtil.fail(resultMap);
- }
- // 2. 拉取用户信息(需 scope 为 snsapi_userinfo)
- // 根据上一步返回json,获取拉取用户信息凭证-access_token和用户唯一标识-openid
- String accessToken = accessTokenJsonObj.getString("access_token");
- String openId = accessTokenJsonObj.getString("openid");
- // 调用业务接口,通过access_token和openId,拉取用户详情
- String userInfoJson = weChatAuthService.getUserInfoFromWechatUseAccessToken(accessToken, openId);
- log.info("------ 通过access_token和openId,拉取用户详情:{} ------", userInfoJson);
- // 3.接口返回用户详情信息
- resultMap.put("userInfo", userInfoJson);
- // TODO 获取成功用户信息后,系统要完成静默注册-把用户信息注册到系统数据中,存储用户的头像,昵称,openId信息,并给系统用户表增加其它的基本信息
- //返回用户详情
- return ResultBuildUtil.success(resultMap);
- }
复制代码 7、测试
7.1 生成请求微信官方获取用户授权code的请求地址
7.2 获取用户信息
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作! |