Spring Cloud 2026.0.0-RC2 Paddington 发布:版本列车迁移指南
2026 年 11 月 5 日,Spring 官方宣布 Spring Cloud 2026.0.0-RC2(代号 Paddington)发布——这是继 2025.1.x(Oakwood)之后的下一个版本列车,对应 Spring Boot 4.2.x 世代。对还在 Oakwood 上的团队,这是规划迁移的最佳窗口。本文基于官方项目页与博客的权威信息(2026-11-19 抓取),给出版本列车的现状、迁移核对清单与回滚预案。
一、版本列车现状:一张兼容表读懂全局
Spring Cloud 采用"版本列车"(release train)模式:一个 BOM 统一管理几十个子项目的版本。当前全貌:
Spring Cloud 版本列车现状(2026-11-19 官方口径)
├─ 2026.0.0-RC2(Paddington):刚发布 RC2(11-05),适配 Boot 4.2.x
├─ 2025.1.x(Oakwood):当前稳定线(最新 2025.1.4),
│ 适配 Boot 4.0.x 与 4.1.x(2025.1.2 起)
├─ 2025.0.x(Northfields):适配 Boot 3.5.x
├─ 2024.0.x(Moorgate):适配 Boot 3.4.x
└─ 更早列车(Leyton/Kilburn/Jubilee/Ilford/Hoxton…):
标注 EOL,不再支持——还在用的团队该动了
两条关键纪律:列车与 Boot 大版本严格绑定(升级 Boot 必须同步换列车 BOM);始终使用所在列车的最新 SR(service release)——SR 只含 bug 修复与向后兼容特性,升级零成本。
二、迁移核对清单:从 Oakwood 到 Paddington
按官方推荐路径(start.spring.io 生成 → BOM 升级),迁移前逐项核对:
# 1. 确认当前列车与 Boot 版本组合是否在支持矩阵内
mvn dependency:tree | grep -E "spring-cloud-dependencies|spring-boot"
# 2. 升级 BOM(properties 一处改动)
# 2025.1.x(Oakwood) -> 2026.0.0-RC2(Paddington)
mvn -q dependency:resolve 2>&1 | grep -i "could not" | head -10
# 3. 全量测试 + 关键链路集成测试
mvn test -DfailIfNoTests=false
核对清单五项:
| 项 | 核对内容 | 常见坑 |
|---|---|---|
| BOM 版本 | properties 中 spring-cloud.version 升至 2026.0.0-RC2 | 子模块各自硬编码版本号 |
| Boot 配对 | Paddington 对应 Boot 4.2.x(RC2) | Boot 升半级但列车忘升 |
| 子项目 API | Config/Gateway/OpenFeign 的废弃 API 清单 | 只跑单测不跑集成测试 |
| EOL 组件 | Contract 已迁 Stubborn.sh、Pulsar 项目迁新家 | 引用了已移交的坐标 |
| 配置键 | 各 starter 的配置属性重命名 | 启动失败才发现 |
三、RC2 阶段的采用策略
RC(Release Candidate)意味着 API 冻结、只修 bug。三种团队的最优策略不同:
# train_strategy.py:版本列车采用策略决策
def adopt_strategy(team: dict) -> str:
if team["boot"] >= 4.2 or team["willing_early"]:
return "RC2 直接上(测试环境),GA 后一周内生产切换"
if team["boot"] == 4.1:
return "留在 Oakwood 2025.1.4,GA 后整体迁 Paddington"
if team["boot"] < 4.0:
return "先补 Boot 升级欠账——EOL 列车无安全补丁"
return "维持现状,按季度复审"
teams = [
{"boot": 4.1, "willing_early": False},
{"boot": 4.2, "willing_early": True},
{"boot": 3.2, "willing_early": False},
]
for t in teams:
print(t["boot"], "->", adopt_strategy(t))
# EOL 列车团队的最优解是先补欠账——
# RC/GA 节奏再快,也救不了停在 EOL 上的安全风险
四、回滚预案:升级窗口的安全网
任何列车升级都要有回滚预案。BOM 升级的特点是"改一处、全局变",回滚也简单——但要做到分钟级回滚,需要提前准备:
# application.yml:迁移期双轨配置示例
spring:
cloud:
compatibility-verifier:
enabled: true # 升级期打开兼容性校验,快速暴露组合错误
# 回滚脚本要点:BOM 版本参数化,一条命令切回
sed -i "s/2026.0.0-RC2/2025.1.4/g" pom.xml
mvn -q clean package -DskipTests
# 镜像重建 + 滚动回退(k8s rollout undo)
两个容易忽略的点:升级窗口内不要混用两个列车的子项目版本(BOM 统一管理就是为了防这个);RC2 阶段发现的兼容问题要提交 issue——RC 阶段的反馈能进 GA,价值最高。
小结
Spring Cloud 2026.0.0-RC2 Paddington(2026-11-05 发布)把列车带入 Boot 4.2 世代:迁移走"兼容矩阵核对→BOM 一处升级→子项目 API 扫描→全量集成测试"四步,EOL 列车团队优先补欠账;RC2 阶段适合测试环境先行,GA 后一周内生产切换;回滚靠 BOM 参数化+滚动回退。Spring 发布节奏正在加快(下篇详述)——版本列车的欠账,越来越难用"再等等"来拖延。
评论(0)
登录 后参与评论。