# Wxjava Upgrade Guide

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

- Skill: `binarywang/wxjava-upgrade-guide` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add binarywang/wxjava-upgrade-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/binarywang/wxjava-upgrade-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: binarywang (https://skillmd.com/u/binarywang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/binarywang/wxjava-upgrade-guide

---


# WxJava 升级迁移

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

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