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

背景

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

流程

第一步 申请测试公众号

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

测试号界面

我们可以看到，在接口信息配置里，填写的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 {
	// 接口配置信息中的Token
    private 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参数内容，则接入生效，成为开发者成功，否则接入失败。

第四步 配置接口配置信息

回到测试号页面

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

1. URL只支持80和433端口，不要配置其他的端口
2. 配置信息的Token要和CheckUtil一致
   
   成功之后，我们就接入了微信公众号，下面就可以调用微信公众号的接口，进行开发了。