⚠️ JDK 17 基线#

Spring Boot 3.0 要求 Java 17+，Java 8/11 不再支持。

⚠️ javax → jakarta 命名空间迁移#

Jakarta EE 9+ 将所有 javax.* 包名改为 jakarta.*。这是此阶段最广泛的破坏性变动：

迁移工具：

• OpenRewrite Jakarta 迁移配方
• IntelliJ IDEA 内置迁移支持
• spring-boot-properties-migrator 依赖（临时添加，迁移完移除）

⚠️ Spring Framework 6.0#

• ⚠️ 尾部斜杠匹配默认关闭：GET /some/greeting/ 不再匹配 @GetMapping("/some/greeting")
• ⚠️ spring.factories 中 EnableAutoConfiguration key 不再支持，改用 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
• Spring Boot 3.0 使用 Hibernate 6.1，groupId 变为 org.hibernate.orm
• Spring Boot 3.0 使用 Flyway 9.0、Liquibase 4.17+

⚠️ Spring Security 6.0#

• ⚠️ 默认对所有 dispatch type 应用授权（可通过 spring.security.filter.dispatcher-types 配置）
• ⚠️ spring.security.saml2.relyingparty.registration.{id}.identity-provider 属性移除，改用 .asserting-party
• 建议先升级到 Spring Security 5.8 过渡

⚠️ Spring Batch 5.0#

• ⚠️ @EnableBatchProcessing 不再推荐使用，应移除以让 Boot 自动配置生效
• ⚠️ 多 Job 并行运行不再支持，需用 spring.batch.job.name 指定

其他 Breaking Changes（3.0）#

⚠️ Jakarta EE 11 / Servlet 6.1 基线#

Spring Boot 4.0 基于 Jakarta EE 11，要求 Servlet 6.1。这意味着：

• ⚠️ Undertow 被移除（不兼容 Servlet 6.1），无法再使用 Undertow 作为嵌入式服务器
• 需使用 Tomcat 11+ 或 Jetty 12.1+

⚠️ 模块化重构#

Spring Boot 4.0 进行了全面模块化，这是最大的破坏性变动之一：

模块命名规则：

• 模块：spring-boot-<technology>
• 根包：org.springframework.boot.<technology>
• Starter：spring-boot-starter-<technology>
• Test Starter：spring-boot-starter-<technology>-test

⚠️ Starter 重命名：

⚠️ Flyway / Liquibase 现在需要 Starter：

之前只需添加第三方依赖即可，现在必须使用 spring-boot-starter-flyway 或 spring-boot-starter-liquibase。

过渡方案：可先使用 spring-boot-starter-classic + spring-boot-starter-test-classic 快速启动，再逐步迁移到精确 Starter。

⚠️ Jackson 3#

Spring Boot 4.0 默认使用 Jackson 3，这是影响面极广的破坏性变动：

⚠️ 包名 / GroupId 变更：

• com.fasterxml.jackson → tools.jackson（jackson-annotations 例外，仍用 com.fasterxml.jackson.core）

⚠️ 类重命名：

⚠️ 配置属性迁移：

• spring.jackson.read.* → spring.jackson.json.read.*
• spring.jackson.write.* → spring.jackson.json.write.*

Jackson 2 兼容方案：

• 设置 spring.jackson.use-jackson2-defaults=true 对齐旧默认值
• 添加 spring-boot-jackson2 模块（⚠️ 已 deprecated，仅作过渡）
• Jersey 4.0 不支持 Jackson 3，需搭配 spring-boot-jackson2

⚠️ Spring Framework 7.0#

⚠️ @MockBean / @SpyBean 移除#

• ⚠️ 替换为 @MockitoBean 和 @MockitoSpyBean
• ⚠️ 新注解不允许在 @Configuration 类上使用，需在 test class 上声明

⚠️ @SpringBootTest 不再自动提供测试工具#

⚠️ Spring Retry 依赖管理移除#

Spring Retry 已合并到 Spring Framework 7.0 核心中。如果仍需独立 spring-retry，需显式指定版本。

迁移方式：

1
// 旧
2
@EnableRetry
3
// 新
4
@EnableResilientMethods
5

6
// 旧 import
7
import org.springframework.retry.annotation.Retryable;
8
// 新 import
9
import org.springframework.core.retry.annotation.Retryable;

⚠️ Spring Authorization Server 合并入 Spring Security#

• 不再作为独立项目，成为 Spring Security 7.0 的一部分
• ⚠️ spring-authorization-server.version 属性移除，改用 spring-security.version

其他 Breaking Changes（4.0）#

第一阶段：2.7 → 3.0#

• 升级 JDK 到 17+
• 升级到 Spring Boot 2.7.x 最新版本
• 执行 javax → jakarta 包名迁移（OpenRewrite / IDE 工具）
• 更新 spring.factories → AutoConfiguration.imports
• 处理尾部斜杠匹配变更
• 迁移 MySQL 驱动坐标
• 迁移 Elasticsearch 高级 REST Client → 新 Java Client
• 移除 @ConstructorBinding 类型级声明
• 迁移 Spring Security 到 5.8 → 6.0
• 移除 @EnableBatchProcessing（Spring Batch 5）
• 更新配置属性（spring-boot-properties-migrator 辅助）
• 处理所有 deprecated API

第二阶段：3.0 → 3.4+#

• 升级到 3.4.x / 3.5.x
• 修复所有 deprecated 警告
• 确保第三方依赖兼容

第三阶段：3.4+ → 4.0#

• 升级 Spring Framework 到 7.x
• 迁移 Jackson 2 → Jackson 3（或使用 spring-boot-jackson2 过渡）
• 更新 Starter 命名（web → webmvc，aop → aspectj 等）
• 添加缺失 Starter（Flyway / Liquibase 现需 Starter）
• 迁移 @MockBean → @MockitoBean，@SpyBean → @MockitoSpyBean
• 添加 @AutoConfigureMockMvc / @AutoConfigureWebClient 等测试注解
• 迁移 @EnableRetry → @EnableResilientMethods
• 迁移 Spring Retry import 到 org.springframework.core.retry
• 迁移 Null Safety 注解到 JSpecify
• 移除 Undertow（改用 Tomcat 11 / Jetty 12.1）
• 移除 Classic Uber-Jar Loader 配置
• 更新 MongoDB / Elasticsearch / Kafka / AMQP 属性和 API
• 处理 Spring Batch 默认内存模式变更
• 处理 HttpMessageConverters 弃用
• 更新 Security OAuth Starter 命名

总结#

从 Spring Boot 2.7 到 4.x 是一条跨越 Jakarta EE 9/11、JDK 17+、模块化重构、Jackson 3 四大变革的迁移之路。关键策略：

1. 分步走：不要从 2.7 直接跳到 4.0，按 2.7 → 3.0 → 3.5 → 4.0 逐步升级
2. 先修 deprecated：在每个版本上清零 deprecated 警告
3. 善用工具：OpenRewrite、spring-boot-properties-migrator、IDE 迁移支持
4. 过渡 Starter：4.0 的 spring-boot-starter-classic 帮你快速启动
5. Jackson 2 桥接：spring-boot-jackson2 模块给足迁移时间