Spring Boot 版本选型：2/3/4 对比及迁移指南

第三部分：迁移避坑指南（2→3→4）

迁移不是'换版本号'那么简单，常见坑：Jakarta 命名空间变、依赖冲突、测试框架升级。官方建议：先升级到最新子版（如 2.7.x/3.5.x），再跳大版。

2.x → 3.x 迁移步骤 & 避坑

1. 准备：升级到 2.7.x；JDK 到 17；备份代码；跑全测试。
2. 核心升级：pom.xml 改 spring-boot.version=3.5.x；处理 Jakarta（javax.* → jakarta.*，用 OpenRewrite 自动化替换）。
3. 依赖处理：升级 Spring Data、Security 等；移除 deprecated API。
4. 测试/运行：更新 JUnit 到 5；修复 Native/AOT 问题；验证启动/性能。

• 常见坑：Hibernate/JPA 兼容；XML 解析变；安全配置失效。解决：用 Moderne 工具扫描，预计中型项目 1 周。

3.x → 4.x 迁移步骤 & 避坑

1. 准备：升级到 3.5.x；JDK 到 21/25；审视 starters（autoconfigure 拆分）。
2. 核心升级：version=4.0.x；添加新 starters（如 spring-boot-starter-flyway）；修复包导入。
3. 依赖处理：Jackson 2→3（序列化变）；JUnit 5→6；Gradle 8+。
4. 测试/运行：验证模块化瘦身；优化 Native 编译；监控 Observability。

• 常见坑：依赖树爆炸；H2 控制台失效；自定义 starters 兼容。解决：用 Arconia 工具一键迁；小 PR 分批审。中型项目 1-2 天，大型需自动化。

第四部分：Java 8→21 适配要点（与 Spring Boot 结合）

SB3/4 要求 Java17+，推荐 21/25。直接从 8 跳 21 风险大，建议分步：8→11→17→21。

• 关键适配：1. 模块系统（–add-opens 修复反射）；2. Deprecated API 替换（javax→jakarta）；3. 虚拟线程（SB3+ 用 Project Loom 提升并发）；4. Records/Sealed Classes 优化代码；5. GC/性能调优（ZGC/Shenandoah 减停顿）。
• 与 SB 结合：SB3 用 Java17 虚拟线程重构线程池；SB4 用 Java25 GC 瘦身内存。工具：OpenRewrite 自动化迁（jdeps 分析）。避坑：Mockito/JaCoCo 升级；生产渐进 rollout。

结语：选对版本，事半功倍

Spring Boot 4.x 是主流选择，能带来性能、安全和可维护性跃升。但迁移需谨慎，先小步测试。无论新老项目，结合 JDK 升级，能让你的应用'永葆青春'。