Java微信网页授权开发

偏执的太偏执、 2023-05-22 08:55 10阅读 0赞

### 1.微信网页授权access\_token与普通access\_token区别 ###

1.  有效期：两者有效时间都是 7200s；
2.  使用范围：通过网页授权获得的access\_token，只能获取到对应的微信用户信息，与微信用户是一对一关系；而普通的access\_token在有效期内可以使用，可以获取所有用户信息。
3.  次数限制：普通access\_token每天获取最多次数为2000次；而网页授权的access\_token获取次数没有限制。

### 2.授权回调URI传递自定义参数 ###

> 注意：微信授权回调uri不能带端口号

我的回调地址是：https://m.abc.com/#/pages/user/register?phone=15300220033
    说明：
    phone是自定义参数；
    https://m.abc.com/#/pages/user/register是前端的地址；

流程是：发起授权->用户同意授权->微信回调到前端->前端获取到微信code/state和自定义参数phone->前端通过phone从接口查询userId；通过code从接口获取unionId->前端把unionId和userId传给注册接口->接口完成后续逻辑。

以下代码用于拼接授权url：

// 自定义参数拼接
    String args = String.format("?phone=%s", phone);
    
    /**
     * 获取微信授权url
     */
    public static String getAuthUrl(String appId, String callBackUrl, String state, String args) throws UnsupportedEncodingException {
    
        String redirect_uri = URLEncoder.encode(callBackUrl + args, "UTF-8");
    
        String url = "https://open.weixin.qq.com/connect/oauth2/authorize?" +
                "appid=APPID" +
                "&redirect_uri=REDIRECT_URI" +
                "&response_type=code" +
                "&scope=SCOPE" +
                "&state=STATE" +
                "#wechat_redirect";
        return url.replace("APPID",appId)
                .replace("REDIRECT_URI",redirect_uri)
                .replace("SCOPE","snsapi_userinfo")
                .replace("STATE",state);
    }

通过以上代码拼接的发起授权的url：

[https://open.weixin.qq.com/connect/oauth2/authorize?appid=myappid&redirect\_uri=https%3A%2F%2Fm.abc.com%2F%23%2Fpages%2Fuser%2Fregister%3Fphone%3D15300220033&response\_type=code&scope=snsapi\_userinfo&state=70a38dd8b640491a93347614bc1d4ec6\#wechat\_redirect][https_open.weixin.qq.com_connect_oauth2_authorize_appid_myappid_redirect_uri_https_3A_2F_2Fm.abc.com_2F_23_2Fpages_2Fuser_2Fregister_3Fphone_3D15300220033_response_type_code_scope_snsapi_userinfo_state_70a38dd8b640491a93347614bc1d4ec6_wechat_redirect]

微信回调url：

[https://m.abc.com/?code=0817Cznv0FmkBg19vFnv0G1ynv07Cznp&state=70a38dd8b640491a93347614bc1d4ec6\#/pages/user/register?phone=15300220033][https_m.abc.com_code_0817Cznv0FmkBg19vFnv0G1ynv07Cznp_state_70a38dd8b640491a93347614bc1d4ec6_pages_user_register_phone_15300220033]

这样就实现了授权回调uri携带自定义参数的目的。

### 3.前后端分离，网页授权设计方案 ###

微信公众号网页授权登录，因为是前后端项目，所以跳转是在前端做的，所以回调地址配置的是前端页面地址。

前端需要的步骤是：

1、访问后端接口，获取微信授权url。

2、前端跳转到该授权url。

3、用户点击授权，微信自动会跳转一个重定向页面，也就是回调页面。

4、前端获取到重定向链接上的code，截取下来发送个后端。（这个链接地址是你自己设置的，就是授权成功你需要跳回的页面，然后微信会在这个页面上地址上加上一个code）

5、后端会根据传过去的code，向微信请求头像昵称等；

后面的事情就是交给后端了。

### 4.防篡改，state用法 ###

发起授权时，生成state值，并拼接到授权url上

// state（防止csrf攻击）存入缓存，有效期60秒
    String state = UUID.randomUUID().toString().replaceAll("-", "");
    redisTemplate.opsForValue().set(String.format(WX_CACHE_KEY_STATE, state), "1", 60, TimeUnit.SECONDS);

回调回来时，校验state

//判断state是否合法
    if (StringUtils.isBlank(code) || StringUtils.isBlank(state) || ! isValidState(state)) {
       return Result.error("登录超时，请重新登录");
    }
    
        /**
         * 校验state
         */
        @Override
        public boolean isValidState(String state) {
            String key = String.format(WX_CACHE_KEY_STATE, state);
            String value = redisTemplate.opsForValue().get(key);
            // 校验一次就删除
            redisTemplate.delete(key);
            return StringUtils.isNotBlank(value);
        }

### 5.其他 ###

> 网页授权回调地址配置可以带端口吗?

答：必须是80端口。否则，报redirect\_uri参数错误。改成80端口就好了。

测试号支持授权回调地址带端口号。例如：test.aaa.com:9090

> 微信公众号提示10005错误

①订阅号没有相关的权限

②账号没有认证，没有相关的权限

③scope 参数位置错误

首先检查您的微信号是服务号还是订阅号, 如果是订阅号，腾讯没有开放接口，故没有权限；

授权回调域名配置规范为全域名且不带http，假如需要网页授权的域名为：”www.qq.com“，配置以后此域名下面页面“http://www.qq.com/music.html、http://www.qq.com/login.html ”都可以进行OAuth2.0鉴权。

> Scope 参数错误或没有Scope权限

用订阅号的appId发起授权登录，会提示“Scope 参数错误或没有Scope权限”。因为订阅中没有获取到微信网页授权接口的权限。

> redirect\_uri域名与后台配置不一致

查看公众号配置的域名和redirect\_uri后面你传的参数域名是否一致。配置的域名不能带端口，不能带http

> 必须关注此测试号,错误码10006

需要关注自己的测试号呀。测试号管理下面有一个测试号二维码，关注一下就可以了。

[https_open.weixin.qq.com_connect_oauth2_authorize_appid_myappid_redirect_uri_https_3A_2F_2Fm.abc.com_2F_23_2Fpages_2Fuser_2Fregister_3Fphone_3D15300220033_response_type_code_scope_snsapi_userinfo_state_70a38dd8b640491a93347614bc1d4ec6_wechat_redirect]: https://open.weixin.qq.com/connect/oauth2/authorize?appid=myappid&redirect_uri=https%3A%2F%2Fm.abc.com%2F%23%2Fpages%2Fuser%2Fregister%3Fphone%3D15300220033&response_type=code&scope=snsapi_userinfo&state=70a38dd8b640491a93347614bc1d4ec6#wechat_redirect
[https_m.abc.com_code_0817Cznv0FmkBg19vFnv0G1ynv07Cznp_state_70a38dd8b640491a93347614bc1d4ec6_pages_user_register_phone_15300220033]: https://m.abc.com/?code=0817Cznv0FmkBg19vFnv0G1ynv07Cznp&state=70a38dd8b640491a93347614bc1d4ec6#/pages/user/register?phone=15300220033