SpringBoot版本升级指南：x到x新特性与迁移注意事项

原创已于 2025-03-28 23:07:55 修改 · 1k 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #后端 #java

于 2025-03-28 11:04:31 首次发布

Web 专栏收录该内容

583 篇文章

订阅专栏

🎓博主介绍：Java、Python、js全栈开发 “多面手”，精通多种编程语言和技术，痴迷于人工智能领域。秉持着对技术的热爱与执着，持续探索创新，愿在此分享交流和学习，与大家共进步。
📖DeepSeek-行业融合之万象视界(附实战案例详解100+)
📖全栈开发环境搭建运行攻略：多语言一站式指南(环境搭建+运行+调试+发布+保姆级详解)
👉感兴趣的可以先收藏起来，希望帮助更多的人

Spring Boot 版本升级指南：2.3 到 2.4 新特性与迁移注意事项

一、引言

Spring Boot 作为 Java 开发领域的主流框架，其版本的不断更新为开发者带来了更多的便利和新特性。从 Spring Boot 2.3 升级到 2.4 版本，虽然在大部分功能上保持了向后兼容性，但仍有一些重要的变化和新特性需要开发者了解。本文将详细介绍 Spring Boot 2.4 相较于 2.3 的新特性，以及在升级过程中需要注意的事项，帮助开发者顺利完成版本迁移。

二、Spring Boot 2.4 新特性

2.1 依赖管理改进

Spring Boot 2.4 对依赖管理进行了优化，引入了 dependencyManagement 中 bom 的概念。现在，Spring Boot 的 spring-boot-dependencies 不再直接管理所有依赖的版本，而是通过 spring-boot-bom 来管理。以下是一个示例：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-bom</artifactId>
            <version>2.4.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

这种方式使得依赖管理更加清晰和灵活，开发者可以更方便地控制依赖的版本。

2.2 配置属性绑定改进

在 Spring Boot 2.4 中，配置属性绑定有了一些改进。现在，@ConfigurationProperties 注解支持更多的嵌套结构和集合类型的绑定。例如：

@ConfigurationProperties(prefix = "myapp")
public class MyAppProperties {
    private List<String> servers;
    private Map<String, String> settings;

    // Getters and setters
    public List<String> getServers() {
        return servers;
    }

    public void setServers(List<String> servers) {
        this.servers = servers;
    }

    public Map<String, String> getSettings() {
        return settings;
    }

    public void setSettings(Map<String, String> settings) {
        this.settings = settings;
    }
}

在 application.properties 中可以这样配置：

myapp.servers[0]=server1
myapp.servers[1]=server2
myapp.settings.key1=value1
myapp.settings.key2=value2

2.3 自动配置优化

Spring Boot 2.4 对自动配置进行了进一步优化，减少了不必要的自动配置类的加载。同时，引入了新的 @AutoConfiguration 注解，用于替代旧的 @Configuration 和 @ConditionalOnClass 组合。示例如下：

@AutoConfiguration
@ConditionalOnClass(MyService.class)
public class MyAutoConfiguration {
    @Bean
    public MyService myService() {
        return new MyService();
    }
}

2.4 Actuator 改进

Actuator 是 Spring Boot 提供的用于监控和管理应用程序的工具。在 2.4 版本中，Actuator 有了一些改进。例如，新增了一些端点，同时对现有端点的输出格式进行了优化。可以通过以下配置启用 Actuator：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

在 application.properties 中配置端点暴露：

management.endpoints.web.exposure.include=*

三、迁移注意事项

3.1 依赖替换

由于 Spring Boot 2.4 对依赖管理进行了改进，需要将原有的 spring-boot-dependencies 替换为 spring-boot-bom。在 pom.xml 中进行如下修改：

<!-- 原有的依赖管理 -->
<!-- <dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.3.0.RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement> -->

<!-- 替换为新的依赖管理 -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-bom</artifactId>
            <version>2.4.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3.2 配置属性调整

在 Spring Boot 2.4 中，一些配置属性的名称或行为发生了变化。例如，server.port 配置属性的加载方式有所不同。需要确保在 application.properties 或 application.yml 中正确配置相关属性。

3.3 测试框架兼容性

如果项目中使用了测试框架，如 JUnit 和 Mockito，需要确保这些框架的版本与 Spring Boot 2.4 兼容。可以通过以下方式更新依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
    <exclusions>
        <exclusion>
            <groupId>org.junit.vintage</groupId>
            <artifactId>junit-vintage-engine</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter</artifactId>
    <scope>test</scope>
</dependency>