JAVA 21 Spring Boot 4 学习--迁移指南 Migration Guide

作为 Spring Boot 3.x 之后的首个大版本更新，Spring Boot 4.0 基于 Spring Framework 7.0、Jakarta EE 11 和 Java 17+（推荐 Java 21 或 25），带来了模块化架构重构、虚拟线程原生支持、HTTP 服务客户端自动配置等重大变化。

迁移前准备

升级到最新的3.5.x版本

1. 官方建议升级 4.x之前，先升级至3.5.x的最新版本，因为这会确保你的项目根据最新的依赖项进行构建
2. 花时间检查项目中对 deprecated方法的调用，这些将要在4.x版本中删除

review Dependencies【依赖项】

spring boot 4.x更新了大量的依赖项，
可以review 从dependency management for3.5.x到 dependency management for4.0.x的依赖项变化，来评估针对项目的影响

如果你的项目使用了不受Spring Boot管理的依赖项，如Spring Cloud, 则需要升级至兼容的版本

Review System Requirements

• Spring Boot 4.0需要Java 17+。建议使用最新的Java LTS版本。
• Spring Boot应用程序也可以使用Kotlin开发，但需要使用v2.2+
• 如果使用GraalVM native-image，则必须使用Java 25 +
• Spring Boot 4基于Jakarta EE 11，需要Servlet 6.1基线。
• 如果您直接管理依赖项，请确保升级至兼容版本

Review Deprecations from Spring Boot 3.x

Spring Boot 3.x中弃用【deprecated】的类、方法、属性在 4.x版本中已经删除。请确保在升级之前没有调用deprecated的方法

升级至 Spring Boot 4

检查完项目及其依赖项的状态后，升级到Spring Boot 4.0的最新维护版本

4.x中被移除的特性

Undertow

因为不兼容Servlet 6.1 baseline，官方不建议将4.x的应用运行在不兼容servlet 6.1的容器中

Pulsar Reactive

在决定移除Spring Pulsar中的反应器支持之后

• Spring Boot不再管理reactive Pulsar客户端。
• Spring Pulsar Reactive的自动配置也被移除。

Embedded Executable Uber Jar Launch Scripts

对用于创建“完全可执行【fully executable】”jar文件的嵌入式启动脚本的支持已被删除。这种支持是特定于类unix操作系统的，并且有许多限制

可以使用Spring Boot的构建插件创建uber jars，并使用java -jar运行它们

Spring Session Hazelcast

Spring Session Hazelcast is now under the leadership of the Hazelcast team. As such, direct support for Spring Session Hazelcast has been removed from Spring Boot itself.

Spring Session MongoDB

Spring Session MongoDB is now under the leadership of the MongoDB team. As such, direct support for Spring Session MongoDB has been removed from Spring Boot itself.

Spock集成

Spring Boot的Spock集成已经被删除,因为Spock还没有支持Groovy 5。

模块化架构

Spring Boot 4.0有了新的模块化设计，
Spring Boot 4 将spring-boot-autoconfigure拆分为多个专注的模块，每个技术都有独立的 starter 和对应的测试 starter。

main code变化

• 模块命名：spring-boot-<technology>
• 包路径：org.springframework.boot.<technology>
• Starter 命名：spring-boot-starter-<technology>
• 之前没有 starter 的技术（如 Flyway、Liquibase）现在需要显式添加对应的 starter

test code变化

• 模块命名：spring-boot-<technology>-test，
• 包路径：org.springframework.boot.<technology>-test
• Test Starter 命名：spring-boot-starter-<technology>和spring-boot-starter-<technology>-test

模块化的优势

• 减少 IDE 干扰：IDE 自动完成只显示你实际使用的技术相关的类和配置属性，不再出现无关的代码提示。例如，如果你不使用 GraphQL，IDE 不会提示 GraphQL 相关的配置属性
• 更小的运行时占用：只引入实际使用的模块，减少类路径开销和启动扫描成本。Spring Boot 3.5 的spring-boot-autoconfigure是 2 MiB，模块化后只引入需要的模块，显著减少占用
• 避免意外自动配置：模块化后，Spring Boot 能更准确地判断你的意图。例如，如果只使用WebClient（通过spring-boot-starter-webclient），不会意外启用 Web 服务器自动配置，不再需要调用SpringApplication.setWebApplicationType(WebApplicationType.NONE)
• 启用新用例：例如，现在可以独立使用 Micrometer 指标（spring-boot-starter-micrometer-metrics），而不需要完整的 Actuator 依赖链
• 更好的维护性：模块边界成为明确的契约，而不是软约定，便于团队协作和代码维护

Classic Starter 【快速迁移方案】

如果你正在升级一个现有的应用程序，只是想快速运行，你可以使用“Classic Starter POMs”。classic starter提供了所有模块，但排除了它们所有的可传递依赖。这提供了一个与上一代Spring Boot非常相似的设置，其中所有自动配置类都是可用的。