wxjava-upgrade-guide git:20260720.871b042A

Immutable. This exact content is served forever at /api/v1/blob/adfba1e951f2c8f1.

---
name: wxjava-upgrade-guide
description: 规划 WxJava 的版本升级与迁移，检查 BOM、模块依赖、Java 版本、配置与公共 API 兼容性，并提供可回滚的验证步骤。适用于用户从旧版升级、切换依赖管理方式、处理兼容性告警或制定升级发布计划时。
---

# WxJava 升级迁移

1. 收集当前与目标版本、已用模块、JDK、框架、BOM 使用情况、依赖树、代理配置和关键调用路径。
2. 读取 [迁移检查表](references/migration.md)，识别版本、依赖和配置边界。
3. 按 HTTP 客户端、BOM、支付/回调、多账号、企业微信会话存档等变化类型选择迁移分支。
4. 输出分阶段变更：依赖调整、编译、关键回归测试、灰度与明确回滚条件。
5. 将不确定项标为待查，并引导查看目标版本的 release notes、README、Javadoc 与变更记录。

不要猜测废弃 API 或破坏性变更；以官方发布信息、当前代码与实际编译结果为准。默认保持 Java 8，除非目标版本明确改变此约束。不能以关闭验签、固定 token 或跳过测试作为回滚方案。