记一次微信公众号开发记录

时间 2019-11-17

标签一次微信公众号开发记录繁體版

原文原文链接

记一次微信公众号开发记录

微信公众号开发仍是相对简单的，来来回回写过几回了，一直没有详细的记录下来，致使每次写仍是要查文档，现将此次开发经历记录下来，以备不时之需。html

pom.xml文件中引入下面的三方sdk

<!--微信公众号三方sdk-->
<dependency>
    <groupId>com.github.binarywang</groupId>
    <artifactId>wx-java-mp-spring-boot-starter</artifactId>
    <version>3.5.0</version>
</dependency>
复制代码

微信开发 Java SDK（开发工具包），官网还有支持包括微信支付、开放平台、小程序、企业微信/企业号的sdk，简直好用！！！前端

application.yml配置

# 公众号配置(必填)
wx:
 mp:
 appId: APPID        #微信公众号的appid
 secret: SECRET      #微信公众号的app corpSecret
 token: TOKEN        #微信公众号的token
 aesKey: AESKEY      #微信公众号的EncodingAESKey
复制代码

重定向进行微信网页受权获取用户信息并重定向回去

思路

1. 提供一个前端重定向过来的入口，URL上携带一个redirect_url参数（表明从微信获取用户信息后要重定向回去的页面），并在此处跳转到微信进行网页受权。
2. 受权成功后获取code。
3. 经过code调微信接口获取openid和access_token。
4. 获取用户信息。
5. 最后重定向回最初的redirect_url，并拼上想要的参数。
复制代码

实现

1. 首先提供一个前段重定向过来的入口，URL上携带一个redirect_url参数（表明从微信获取用户信息后要重定向回去的页面），并在此处跳转到微信进行网页受权。
复制代码

注意java

redirect_url须要通过URLEncoder，拿到以后再进行URLDecoder,不然redirect_url中#以后的部分会丢掉。git

最好进行两次URLEncoder，两次URLDecoder，由于有的浏览器会自动解码。github

//微信受权后返回的地址
private String getCodeUrl = "项目域名" + "redirect/code?redirect_url=";

//默认重定向地址defaultUrl
private String defaultUrl = "[DEFAULT_URL]";

//提供的获取用户信息的重定向入口地址
@GetMapping("/redirect")
public String redirect( @RequestParam(name = "redirect_url", defaultValue = "", required = false) String redirectUrl ) throws UnsupportedEncodingException {

    //默认重定向地址defaultUrl
    if (StringUtils.isBlank(redirectUrl)) {
        redirectUrl = defaultUrl;
    } else {
        redirectUrl = URLDecoder.decode(redirectUrl, "utf-8");
        LOGGER.info("一次解码：{}",redirectUrl);
        redirectUrl = URLDecoder.decode(redirectUrl, "utf-8");
        LOGGER.info("二次解码：{}",redirectUrl);
    }
    
    LOGGER.info("redirectUrl:{}",redirectUrl);
    
    //一次编码
    redirectUrl = URLEncoder.encode(redirectUrl, "utf-8");
    LOGGER.info("一次编码url:{}",redirectUrl);
    //二次编码
    redirectUrl = URLEncoder.encode(getCodeUrl + redirectUrl, "utf-8");
    LOGGER.info("二次编码url:{}",redirectUrl);
    //最终获得微信受权地址
    String url = wxMpService.oauth2buildAuthorizationUrl(redirectUrl,"snsapi_userinfo","123");
    LOGGER.info("最终获得微信受权地址:{}",url);
    //跳转受权
    return "redirect:" + url;
}
复制代码

2. 受权成功后获取code。
3. 经过code调微信接口获取openid和access_token。
4. 获取用户信息。
5. 最后重定向回最初的redirect_url，并拼上想要的参数。
复制代码

下面完成二、三、四、5步spring

须要定义一个链接，就是上一步中的getCodeUrl，由微信受权成功后重定向到这个连接，并携带code参数。小程序

因为上一步咱们将redirect_url进行了两次编码，因此redirect_url也会传递进来。api

//错误页面errorPage
private String errorPage = "[ERROR_PAGE]";

//这里的地址由微信重定向跳转，携带获取的code参数。
@GetMapping("/redirect/code")
public void getCode( @RequestParam(name = "redirect_url", defaultValue = "", required = false) String redirectUrl, @RequestParam(name = "code", defaultValue = "", required = false) String code, HttpServletRequest request,HttpServletResponse response ) throws IOException {
    LOGGER.info("redirect_url: {}", redirectUrl);
    LOGGER.info("code: {}", code);
    if (StringUtils.isBlank(code)) {
        LOGGER.error("获取code失败");
        LOGGER.info("重定向到错误页，errorPage：{}",errorPage);
        response.sendRedirect(errorPage + "?error=code-is-null");
    }
    //解码重定向地址
    redirectUrl = URLDecoder.decode(redirectUrl, "utf-8");

    LOGGER.info("解码重定向地址url:{}",redirectUrl);

    //根据code获取微信相关信息
    try {
        //根据code获取openid和access_token
        WxMpOAuth2AccessToken wxMpOAuth2AccessToken = wxMpService.oauth2getAccessToken(code);

        //获取微信用户信息
        WxMpUser wxMpUser = wxMpService.getUserService().userInfo(wxMpOAuth2AccessToken.getOpenId());
        LOGGER.info("userInfo:{}",wxMpUser.toString());
    } catch (WxErrorException e) {
        e.printStackTrace();
        LOGGER.info("重定向到错误页，errorPage：{}",errorPage);
        response.sendRedirect(errorPage + "?error=" + e.getMessage());
    }

    //这里直接将微信用户信息编码后重定向给最开始的redirect_url
    response.sendRedirect(redirectUrl + "?wechat_user=" + URLEncoder.encode(wxMpUser.toString(), "utf-8"));
}
复制代码

微信模版消息推送

微信模板消息推送也比较简单，核心代码只有下面几行，最主要的获取用户openid在上面已经讲过，在这里就再也不赘述。浏览器

public String push() throws Exception {

    //推送消息
    WxMpTemplateMessage templateMessage = WxMpTemplateMessage.builder()
            .toUser("[OPENID]")         //要推送的用户openid
            .templateId("[TEMPLATEID]") //模版id
            .url("[URL]")               //点击模版消息要访问的网址
            .build();

    templateMessage.addData(new WxMpTemplateData("first","[标题]","[COLOR]"));
    templateMessage.addData(new WxMpTemplateData("keyword1","[消息主体]","[COLOR]"));
    
    ...//keywordn是模板规定的
    
    templateMessage.addData(new WxMpTemplateData("remark","[备注]","[COLOR]"));
    
    //开始推送
    try {        
        wxMpService.getTemplateMsgService().sendTemplateMsg(templateMessage);

        return "true";
    } catch (WxErrorException e) {
        System.out.println("推送失败：" + e.getMessage());
        e.printStackTrace();
        WxError wxError = e.getError();
        if ("43004".equals(wxError.getErrorCode())){
            throw new Exception("该用户未关注公众号");
        }
        throw new Exception(wxError.getErrorMsg());
    }
}
复制代码

参考

www.cnblogs.com/hebaibai/p/…微信

developers.weixin.qq.com/community/d…