公众号接入

本章节，讲解如果将你的公众号，接入到系统中。步骤如下：

- 第一步，申请公众号（可选）
- 第二步，在系统中，添加公众号账号
- 第三步，在公众号中，配置接入信息
## 1. 配置步骤
本小节，手把手教你如何将公众号接入到系统中。

### 第一步，申请公众号（可选）
① 如果你还没有公众号，可以申请一个测试帐号。

![](/media/202408/2024-08-29_143804_774554.png)
申请地址：[微信公众平台接口测试帐号申请](http://https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login "微信公众平台接口测试帐号申请")

② 申请完成后，获得一个测试号。如下图所示：

![](/media/202408/2024-08-29_143829_594231.png)
### 第二步，添加公众号账号
点击 [公众号管理 -> 账号管理] 菜单，添加一个公众号账号。如下图所示：

![](/media/202408/2024-08-29_143841_759794.png)
### 第三步，配置接入信息
① 由于公众号通知需要外网地址，可参考 《内网穿透》 文档，将本地的 48080 端口，转发到外网中。这里，我的域名是 http://yunai.natapp1.cc。

② 打开微信公众号界面，填写 URL 和 Token 信息。如下图所示：

![](/media/202408/2024-08-29_143903_222598.png)
点击提交后，看到“配置成功”提示，说明配置成功。

## 2. 实现代码
本小节，将介绍如何实现公众号接入的代码。

### 2.1 表结构
公众号账号对应 mp_account 表，结构如下图所示：

![](/media/202408/2024-08-29_143924_626362.png)

## 2.2 配置接入回调#2.2 配置接入回调
在 第三步，配置接入信息 时，微信公众号会回调系统的 GET /admin-api/mp/open/{appID} 接口，进行接入配置的验证。对应 MpOpenController 类的 checkSignature 方法，如下图所示：

![](/media/202408/2024-08-29_144008_039743.png)
对应 [《微信公众号官方文档 —— 接入指南》](http://https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html#%E7%AC%AC%E4%BA%8C%E6%AD%A5%EF%BC%9A%E9%AA%8C%E8%AF%81%E6%B6%88%E6%81%AF%E7%9A%84%E7%A1%AE%E6%9D%A5%E8%87%AA%E5%BE%AE%E4%BF%A1%E6%9C%8D%E5%8A%A1%E5%99%A8 "《微信公众号官方文档 —— 接入指南》") 文档。

> <span style="font-family:楷体">友情提示：
项目使用的微信工具开发包是 [weixin-java-mp](http://https://github.com/Wechat-Group/WxJava/tree/develop/weixin-java-mp "weixin-java-mp") ，超级好用！
</span>

### 2.3 消息处理
配置接入完成后，用户发给公众号的消息，公众号都会回调到 POST /admin-api/mp/open/{appID} 接口，进行消息的处理。对应 MpOpenController 类的 handleMessage 方法，如下图所示：

![](/media/202408/2024-08-29_144209_916198.png)

核心逻辑是第二步，再解析到消息后，交给 WxMpMessageRouter 进行消息的处理。WxMpMessageRouter 在 DefaultMpServiceFactory (opens new window)初始化，设置每种消息对应的 handler 处理器。如下图所示：

![](/media/202408/2024-08-29_144217_909337.png)
具体每个处理器的实现，后续每个章节单独详细讲解。