微信公众号开发之授权获取用户信息

2022-12-07 10:22:28

微信开发交流群：148540125

系列文章参考地址极速开发微信公众号
欢迎留言、转发

项目源码参考地址点我点我–欢迎Start

前几篇文章已讲完如何导入项目，如何启动配置项目，如何成为开发者，重源码分析消息是如何交互、如何自定义菜单（如果以上不是很清楚可以看这里极速开发微信公众号。这篇文章就来聊聊授权获取用户信息

一、什么是OAuth2.0

这里整理了一篇文章理解OAuth2.0

二、微信公众平台OAuth2.0授权详细步骤

用户关注微信公众账号(现在也可以不关注)。
微信公众账号提供用户请求授权页面URL。
用户点击授权页面URL，将向服务器发起请求
服务器询问用户是否同意授权给微信公众账号(scope为snsapi_base时无此步骤)
用户同意(scope为snsapi_base时无此步骤,不弹出授权页面，直接跳转，只能获取用户openid)
服务器将code参数通过回调传给微信公众账号
微信公众账号获得code参数
微信公众账号通过code参数向服务器请求Access Token
服务器返回Access Token和OpenID给微信公众账号
1. 微信公众账号通过Access Token向服务器请求用户信息(scope为snsapi_base时无此步骤)
2. 服务器将用户信息回送给微信公众账号(scope为snsapi_base时无此步骤)

三、配置授权回调页面域名

沙盒号(测试号)回调地址支持域名和ip，正式公众号回调地址只支持域名并且域名需使用字母、数字及“-”的组合，须通过ICP备案的验证，不支持端口号及短链。

测试号：找到 网页授权获取用户基本信息>点击修改>设置域名
服务号：找到 开发>接口权限>网页授权获取用户基本信息>>点击修改>设置域名
设置域名不要添加http

详细介绍参考官方文档

四、用户授权并获取code ，使用code换取access_token 并使用access_token获取用户信息

授权访问的URL：

https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect

具体封装实现可以查看

com.jfinal.weixin.sdk.api.SnsAccessTokenApi.getAuthorizeURL(....) 方法

之前博客使用Servlet 也写了一个简单的授权参考地址

五、使用封装的接口实现授权获取用户信息

封装之后使用就非常的简单，SnsAccessTokenApi.getAuthorizeURL(....)
- 第一个参数为appId
- 第二个参数为授权后回调的地址http://域名/oauth
- 第三个参数为state 重定向后会带上state参数，开发者可以填写a-zA-Z0-9的参数值，最多128字节第四个参数应用授权作用域，简单讲是否弹出授权页面。 true 为不弹出授权页面

应用授权作用域，snsapi_base （不弹出授权页面，直接跳转，只能获取用户openid），snsapi_userinfo （弹出授权页面，可通过openid拿到昵称、性别、所在地。并且，即使在未关注的情况下，只要用户授权，也能获取其信息）

具体实现代码如下

//跳转到授权页面
  public void toOauth(){
    String calbackUrl=PropKit.get("domain")+"/oauth";
    String url=SnsAccessTokenApi.getAuthorizeURL(PropKit.get("appId"), calbackUrl, "111",false);
    redirect(url);
  }

oauth Controller 具体实现步骤如下：
- 当用户同意授权，获取code以及state
- 如果code不为null，就可以通过code换取网页授权access_token

{ 
 "access_token":"ACCESS_TOKEN",    
 "expires_in":7200,    
 "refresh_token":"REFRESH_TOKEN",    
 "openid":"OPENID",    
 "scope":"SCOPE" 
}

拉取用户信息(需scope为 snsapi_userinfo)

{    
 "openid":" OPENID",  
 " nickname": NICKNAME,   
 "sex":"1",   
 "province":"PROVINCE"   
 "city":"CITY",   
 "country":"COUNTRY",    
 "headimgurl":    "http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ
4eMsv84eavHiaiceqxibJxCfHe/46",  
"privilege":[ "PRIVILEGE1" "PRIVILEGE2"     ],    
 "unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL" 
}

获取用户信息之后可以根据上面的state跳转到不同的页面

具体实现代码如下

public class WeiXinOauthController extends ApiController{
  static Log log = Log.getLog(WeiXinOauthController.class);
  /**
   * 如果要支持多公众账号，只需要在此返回各个公众号对应的  ApiConfig 对象即可
   * 可以通过在请求 url 中挂参数来动态从数据库中获取 ApiConfig 属性值
   */
  public ApiConfig getApiConfig() {
    ApiConfig ac = new ApiConfig();

    // 配置微信 API 相关常量
    ac.setToken(PropKit.get("token"));
    ac.setAppId(PropKit.get("appId"));
    ac.setAppSecret(PropKit.get("appSecret"));

    /**
     *  是否对消息进行加密，对应于微信平台的消息加解密方式：
     *  1：true进行加密且必须配置 encodingAesKey
     *  2：false采用明文模式，同时也支持混合模式
     */
    ac.setEncryptMessage(PropKit.getBoolean("encryptMessage", false));
    ac.setEncodingAesKey(PropKit.get("encodingAesKey", "setting it in config file"));
    return ac;
  }

  public void index() {
    int  subscribe=0;
    //用户同意授权，获取code
    String code=getPara("code");
    String state=getPara("state");
    if (code!=null) {
      String appId=ApiConfigKit.getApiConfig().getAppId();
      String secret=ApiConfigKit.getApiConfig().getAppSecret();
      //通过code换取网页授权access_token
      SnsAccessToken snsAccessToken=SnsAccessTokenApi.getSnsAccessToken(appId,secret,code);
//      String json=snsAccessToken.getJson();
      String token=snsAccessToken.getAccessToken();
      String openId=snsAccessToken.getOpenid();
      //拉取用户信息(需scope为 snsapi_userinfo)
      ApiResult apiResult=SnsApi.getUserInfo(token, openId);

      log.warn("getUserInfo:"+apiResult.getJson());
      if (apiResult.isSucceed()) {
        JSONObject jsonObject=JSON.parseObject(apiResult.getJson());
        String nickName=jsonObject.getString("nickname");
        //用户的性别，值为1时是男性，值为2时是女性，值为0时是未知
        int sex=jsonObject.getIntValue("sex");
        String city=jsonObject.getString("city");//城市
        String province=jsonObject.getString("province");//省份
        String country=jsonObject.getString("country");//国家
        String headimgurl=jsonObject.getString("headimgurl");
        String unionid=jsonObject.getString("unionid");
        //获取用户信息判断是否关注
        ApiResult userInfo = UserApi.getUserInfo(openId);
        log.warn(JsonKit.toJson("is subsribe>>"+userInfo));
        if (userInfo.isSucceed()) {
          String userStr = userInfo.toString();
          subscribe=JSON.parseObject(userStr).getIntValue("subscribe");
        }

        Users.me.save(openId, WeiXinUtils.filterWeixinEmoji(nickName), unionid, headimgurl, country, city, province, sex);
      }

      setSessionAttr("openId", openId);
      if (subscribe==0) {
        redirect(PropKit.get("subscribe_rul"));
      }else {
        //根据state 跳转到不同的页面
        if (state.equals("2222")) {
          redirect("http://www.cnblogs.com/zyw-205520/");
        }else {
          redirect("/login");
        }
      }
    }else {
      renderText("code is  null");
    }
  }
}

六、常见错误

1、请在微信客户端中打开

授权获取用户信息必须在微信客户端中打开或者使用微信提供的测试工具

2、redirect_url 参数错误如下图

请检查appId对应的公众平台中设置的授权域名是否与你项目中配置的域名保持一致

3、测试号测试时提示未关注测试号

测试号测试授权是必须先关注的测试的号，官方这做是为了安全。正式环境使用正式的服务号是不用关注就可以获取用户信息的。

以上是授权获取用户信息的全过程。

欢迎留言、转发
项目源码参考地址点我点我–欢迎Start

码农公寓