SpringBoot 微信公众号消息加密

### Spring Boot 实现微信公众号消息加密解决方案 #### 1. 配置WXBizMsgCrypt工具类 为了实现微信公众号的消息加解密功能，需要引入`wxbizmsgcrypt`工具类。该工具用于对接收到的消息进行验证并解密，在发送消息前进行签名和加密。 ```java import com.github.binarywang.wxpay.util.WxBizMsgCrypt; ``` 此工具依赖于WeChat官方提供的SDK来完成具体的加解密操作[^1]。 #### 2. 创建配置文件 在项目的application.properties或yml中添加必要的参数设置： ```yaml wechat: token: your_token_here # 微信后台设置的安全token encodingAesKey: aes_key # AES加密秘钥 corpId: wxCorpID # 开发者ID(CorpID) ``` 这些属性将在后续初始化`WxBizMsgCrypt`实例时作为构造函数的入参传递进去。 #### 3. 初始化WxBizMsgCrypt对象 创建一个服务层组件用来管理整个应用程序生命周期内的单例`WxBizMsgCrypt`对象: ```java @Service @RequiredArgsConstructor public class WechatEncryptor { private final WxBizMsgCrypt bizMsgCrypt; @PostConstruct public void init() throws AesException { this.bizMsgCrypt = new WxBizMsgCrypt( wechatProperties.getToken(), wechatProperties.getEncodingAesKey(), wechatProperties.getCorpId()); } } ``` 这里利用了Spring框架中的`@PostConstruct`注解确保在Bean加载完成后立即执行初始化逻辑。 #### 4. 处理接收入口请求 当接收到来自微信公众平台的数据包时，先调用`decryptMsg()`方法对其进行校验与解析；而在向客户端返回响应之前，则需调用`encryptMsg()`来进行封装处理。 ```java @PostMapping("/weixin/callback") @ResponseBody public String handleCallback(@RequestBody String xmlData, HttpServletRequest request) { try { // 对POST过来的数据做签名认证以及XML数据格式转换等工作... // 假设已经得到了明文形式的消息体plaintext Map<String, Object> resultMap = wechatEncryptor.getBizMsgCrypt() .decryptMsg(signature, timestamp, nonce, encryptedXml); // ...业务逻辑处理... // 准备好要回应给用户的文本内容responseContent之后， // 使用同样的方式再次调用encryptMsg()将其打包成符合要求的形式再传回给对方。 return wechatEncryptor.getBizMsgCrypt().encryptMsg(responseContent, System.currentTimeMillis(), UUID.randomUUID().toString()); } catch (Exception e) { log.error("Error occurred while processing callback", e); throw new RuntimeException(e.getMessage()); } } ``` 上述代码片段展示了如何在一个典型的回调接口里集成消息安全机制。