| 场景 | 核心模块 |
|---|---|
| 微信公众号 | weixin-java-mp |
| 微信小程序 | weixin-java-miniapp |
| 微信支付 | weixin-java-pay |
| 企业微信 | weixin-java-cp |
| 微信开放平台／第三方平台 | weixin-java-open |
| 视频号／微信小店 | weixin-java-channel |
| 腾讯企点／微信客服 | weixin-java-qidian |
| 微信智能对话／智能语音 | weixin-java-aispeech |
多个模块并用时优先使用 com.github.binarywang:wx-java-bom。Spring Boot 集成从 spring-boot-starters 选择；Solon 集成从 solon-plugins 选择。
只有多个独立微信应用配置时才选择 multi 集成，并先按框架与产品核对目录是否存在：
- Spring Boot：MP、MiniApp、CP、自建/第三方 CP、Pay、Open、Channel 都有相应 multi Starter。
- Solon：仅 MP、MiniApp、CP、Channel 有 multi 插件；Pay、Open、Qidian 目前只有单账号插件，不要推荐不存在的 multi artifact。
- 公众号、小程序和企业微信的消息回调、token 与加解密配置彼此独立；不要因同属一个公司而复用不兼容的凭据或配置对象。
- 企业微信的多应用应使用独立的
WxCpConfigStorage与WxCpServiceImpl；Wiki 明确指出复用 token、AES key 和 URL 会造成安全边界问题。 - 支付能力通常与 MP、MiniApp 或 Open 同时使用：前者处理业务身份和消息，
weixin-java-pay处理商户签名、证书与支付回调。 - 视频号／微信小店接口属于
weixin-java-channel；不要误归入 MP 或 Pay。 - 腾讯企点与微信智能对话是独立 SDK 模块；不要将客服或智能对话需求默认归入 MP、CP 或 Channel。
- 当能力在 MP 与 Open 等模块可能重叠时，按授权主体、官方 API 域和回调场景选择，不要只按“移动端”或“登录”字样判断。先在当前源码和 Issue 中确认覆盖状态，并标注“已确认 / 待查 / 需自行调用底层接口”。
- BOM 适合同时使用多个 WxJava 模块。若项目还导入 Spring Boot 等上游 BOM，升级后执行
mvn help:effective-pom与mvn dependency:tree；历史 #4058 表明依赖管理顺序可能影响 Spring Data Redis 等依赖。