微信公众号开发（一）环境搭建、接口信息配置

微信公众号开发

背景
流程
- 第一步申请测试公众号
- 第二步创建SpringBoot 项目，实现响应接口
- - 1. WaChatController 层
  - 2. CheckUtil
  - 3. SHA1加密
- 第四步配置接口配置信息

背景

最近在做一个微信公众开发的项目，主要包括，自定义菜单，自动回复（关键词回复（可回复多条）、收到消息回复、被关注自动回复），模板消息等功能，现在自定义菜单，自动回复功能接口已经实现，模板消息正在开发中。刚开始搭建环境，与微信对接的时候，在配置接口信息的时候，总是接入失败，现在将问题记录下来。

流程

第一步申请测试公众号

测试号可以体验并测试微信公众平台所有的高级接口，如果是自己的个人微信公众号有很多的接口都用不了，所以推荐大家使用测试号，测试号申请

测试号界面

我们可以看到，在接口信息配置里，填写的URL需要正确响应微信发送的Token验证，所以这个时候我们还不能直接添加URL,需要有一个能够响应微信发送的Token验证的接口才行。

第二步创建SpringBoot 项目，实现响应接口

1. WaChatController 层

@RestController
@RequestMapping("/api")
@Api(tags = "对接微信模块")
public class WeChatController {/*** 功能描述： 签名校验** @param* @author jiaoqianjin* Date: 2020/8/19 9:57*/@GetMapping("/wx")@ApiOperation(value = "签名校验", notes = "签名校验；\n author：焦前进")public void login(HttpServletRequest request, HttpServletResponse response) throws UnsupportedEncodingException {request.setCharacterEncoding("UTF-8");String signature = request.getParameter("signature");String timestamp = request.getParameter("timestamp");String nonce = request.getParameter("nonce");String echostr = request.getParameter("echostr");PrintWriter out = null;try {out = response.getWriter();if (CheckUtil.checkSignature(signature, timestamp, nonce)) {out.write(echostr);}} catch (IOException e) {e.printStackTrace();} finally {out.close();}}}

2. CheckUtil

/*** Description：请求校验* 将token、timestamp、nonce三个参数进行字典序排序* @author jiaoqianjin* Date: 2020/8/19 9:44**/public class CheckUtil {// 接口配置信息中的Tokenprivate static final String token = "jiao";public static boolean checkSignature(String signature, String timestamp, String nonce) {String[] str = new String[]{token, timestamp, nonce};//排序Arrays.sort(str);//拼接字符串StringBuffer buffer = new StringBuffer();for (int i = 0; i < str.length; i++) {buffer.append(str[i]);}//进行sha1加密String temp = SHA1.encode(buffer.toString());//与微信提供的signature进行匹对return signature.equals(temp);}
}

3. SHA1加密

/*** Description：* 将三个参数字符串拼接成一个字符串进行sha1加密* @author jiaoqianjin* Date: 2020/8/19 9:44**/
public class SHA1 {private static final char[] HEX_DIGITS = {'0', '1', '2', '3', '4', '5','6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f'};private static String getFormattedText(byte[] bytes) {int len = bytes.length;StringBuilder buf = new StringBuilder(len * 2);for (int j = 0; j < len; j++) {buf.append(HEX_DIGITS[(bytes[j] >> 4) & 0x0f]);buf.append(HEX_DIGITS[bytes[j] & 0x0f]);}return buf.toString();}public static String encode(String str) {if (str == null) {return null;}try {MessageDigest messageDigest = MessageDigest.getInstance("SHA1");messageDigest.update(str.getBytes());return getFormattedText(messageDigest.digest());} catch (Exception e) {throw new RuntimeException(e);}}
}

这个时候我们的接口已经写好了，但是这个接口外网访问不了，所以没法响应微信的接口。我们可以将项目部署到个人服务器上，或者使用***，使校验接口（api/wx）可以被访问。开发者通过检验signature对请求进行校验。若确认此次GET请求来自微信服务器，请原样返回echostr参数内容，则接入生效，成为开发者成功，否则接入失败。

第四步配置接口配置信息

回到测试号页面

点击提交，是不是成功了呢
注意事项

URL只支持80和433端口，不要配置其他的端口
配置信息的Token要和CheckUtil一致

成功之后，我们就接入了微信公众号，下面就可以调用微信公众号的接口，进行开发了。