| name | wxjava-upgrade-guide |
|---|---|
| description | 规划 WxJava 的版本升级与迁移，检查 BOM、模块依赖、Java 版本、配置与公共 API 兼容性，并提供可回滚的验证步骤。适用于用户从旧版升级、切换依赖管理方式、处理兼容性告警或制定升级发布计划时。 |
- 收集当前与目标版本、已用模块、JDK、框架、BOM 使用情况、依赖树、代理配置和关键调用路径。
- 读取 迁移检查表，识别版本、依赖和配置边界。
- 按 HTTP 客户端、BOM、支付/回调、多账号、企业微信会话存档等变化类型选择迁移分支。
- 输出分阶段变更：依赖调整、编译、关键回归测试、灰度与明确回滚条件。
- 将不确定项标为待查，并引导查看目标版本的 release notes、README、Javadoc 与变更记录。
不要猜测废弃 API 或破坏性变更；以官方发布信息、当前代码与实际编译结果为准。默认保持 Java 8，除非目标版本明确改变此约束。不能以关闭验签、固定 token 或跳过测试作为回滚方案。