Java 微信公众号获取openId

最新推荐文章于 2025-02-23 19:21:23 发布

H_XING海

最新推荐文章于 2025-02-23 19:21:23 发布

阅读量3.2k

点赞数 2

分类专栏： Java

本文链接：https://blog.youkuaiyun.com/H_XINGHAI/article/details/95344369

版权

Java 专栏收录该内容

4 篇文章

订阅专栏

网上参考了很多，从中总结了一下（适合自己的才是最好的）。这里大致总结一些细节性的东西，配置步骤啥的参考他人的即可。首先了解openid到底是个啥：所谓的openid就是公众号普通用户的一个唯一的标识，只针对当前的公众号有效，开发者可以通过openID来获取用户的基本信息，比如说：所在城市，省份，国家，性别等等。（对不同的公众号同一个人普通用户的openID是不同的！）

环境配置阶段

1.申请测试微信公众号（没什么限制性的地方，只需设置几个关键的地方即可）

申请网址：https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login

2.知己知彼（名词理解）

APPID：微信公众号ID

ASPECTSECRET：微信公众号密钥

URL：进行相关接口开发的URL

TOKEN:验证接口的令牌，可以自己定义（需要与在后台自定义的token进行校验，验证成功后才会配置成功）

JS域名：安全设置，调用微信JS-SDK的时候，域名与此相同。一般调试的话填写映射地址，无http://

之后的操作当时我只是为了调试是否能得到openID，所以只用到了App ID和ASPECTSECRET，后面的配置没怎么用到，到文章最后再总结一下其他参数的配置。

后台实现阶段

1.用到的主要的maven依赖包-------------------weixin-java-mp.

        <!--weixin-->
        <dependency>
            <groupId>com.github.binarywang</groupId>
            <artifactId>weixin-java-mp</artifactId>
            <version>2.6.0</version>
        </dependency>

2.配置类（主要是里面WxMpService,我们需要将其封装为我们自己的service，也就是需要写入APPID和SECRET）

@Component
public class WxMpConfig {
    @Value("${wxconfig.AppId}")
    private String AppId;

    @Value("${wxconfig.Secret}")
    private String Secret;


    @Bean
    public WxMpService wxMpService(){
        WxMpService wxMpService = new WxMpServiceImpl();
        WxMpInMemoryConfigStorage ConfigStorage = new WxMpInMemoryConfigStorage();
        ConfigStorage.setAppId(AppId);
        ConfigStorage.setSecret(Secret);
        wxMpService.setWxMpConfigStorage(ConfigStorage);
        return wxMpService;
    }
}

注意：配置文件的信息要配置好，我这里用的是yml格式，用Value进行读取。

3.应用层进行获取openID以及重定向路由：

@RestController
@Slf4j
@RequestMapping("wx")
public class WinxinController {

    //这个就是我们封装好的service
    @Autowired
    private WxMpService wxMpService;

    @GetMapping("openid")
    public Map<String,Object> getOpenId(@RequestParam String code) {

        log.info("微信获取openID 入参：{}",code);
       Map<String,Object> resultMap = new HashMap<>();
        if (StringUtils.isEmpty(code)){
            resultMap.put("404","参数为空");
            return resultMap;
        }
       
        try {
            //未登录过获取openId进行授权
            String openID = null;
            WxMpOAuth2AccessToken accessToken = wxMpService.oauth2getAccessToken(code);
            openID = accessToken.getOpenId();
            resultMap.put("openId",openID);
            return resultMap;

        }catch (WxErrorException e) {
           // e.printStackTrace();    //尽量不要使用这个打印异常，会造成内存锁，使用log日志就好
            log.error(e.getError().getErrorMsg());
            resultMap.put("404","参数为空");
            return resultMap;
        }


@GetMapping("authorize")
    public SinochemHttpResponse<Object> getAuthorize(@RequestParam String url,@RequestParam String state){
        log.info("重定向的页面路由URL：{}",url);
        log.info("获取用户自定义信息：{}",state);

        Map<String,Object> resultMap = new HashMap<>();
        try {
            String redictUrl = wxMpService.oauth2buildAuthorizationUrl(url,WxConsts.OAUTH2_SCOPE_BASE,URLEncoder.encode(state,"UTF-8"));
            resultMap.put("redictUrl",redictUrl);
            return SinochemHttpResponse.success(resultMap);
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
            return SinochemHttpResponse.error("404","获取失败(重定向路由)！");
        }
    }
 }

第二个GET请求主要是用来重定向路由的，如果你的请求在微信直接访问是会报错的，微信有专门的访问机制，先到微信服务器然后回调你自己的路由才能正确的跳转返回数据。WxMpservice里面的函数oauth2buildAuthorizationUrl(),第一个参数是你要跳转的路由,也就是回调地址;第二个参数是作用域范围,(snsapi_userinfo指的是弹出用户授权页面,获取用户的基本信息,即使用户未关注的情况下,只要用户点击确定就可以获取基本信息;snsapi_base指的是不跳出授权页面只能获取用到的openid信息)这里选基本snsapi_base即可;第三个参数state一般是用户自定义的附加信息,可以加密后进行后续调用验证.(个人理解),函数里面的实现都是封装好的,拿来用就可以,也可以你自己去拼接路由:

例如:

https://open.weixin.qq.com/connect/oauth2/authorize?appid=你的APPID&redirect_uri=你的回调地址(也就是跳转地址)&response_type=code&scope=选择的作用域&state=如果有附带信息就写没有就是null#wechat_redirect

第二个GET请求返回的结果就是上面的这种格式．