Spring Boot中spring-boot-starter-parent版本升级实践

Spring Boot作为目前企业级Java开发中应用最广泛的框架之一，版本迭代速度较快。随着项目运行时间增长，旧版本Spring Boot可能会面临安全漏洞、依赖过时、性能不足以及无法兼容新技术等问题。因此，合理升级spring-boot-starter-parent版本成为维护Spring Boot项目的重要工作。

spring-boot-starter-parent不仅仅是一个普通依赖，它继承了Spring Boot官方提供的默认配置，包括依赖版本管理、Maven插件配置、Java编译参数等。升级它会影响整个项目的依赖体系，因此需要采用科学的方法进行版本迁移。

一、为什么需要升级spring-boot-starter-parent版本

Spring Boot版本升级通常并不是为了追求最新版本，而是为了获得更稳定、安全和长期维护的开发环境。

常见升级原因包括：

1. 修复安全漏洞

旧版本Spring Boot可能包含已公开的安全漏洞，例如Spring Framework、Jackson、Tomcat、Log4j等组件漏洞。

通过升级Spring Boot版本，可以同步更新大量基础依赖，降低项目安全风险。

2. 获得新的功能支持

Spring Boot每个大版本都会引入新的功能优化，例如：

• 更完善的自动配置机制；

• 更好的Spring Framework兼容性；

• 新版本Java支持；

• 性能优化；

• 云原生环境适配。

例如，从Spring Boot 2.x升级到3.x后，可以使用Spring Framework 6以及Jakarta EE 9生态。

3. 解决依赖版本过旧问题

长期不升级会导致：

• Maven依赖冲突增加；

• 第三方组件停止维护；

• 无法使用新版中间件客户端；

• 构建环境逐渐失控。

通过升级父工程，可以统一管理项目依赖版本。

二、spring-boot-starter-parent的作用

在Maven项目中，通常通过以下方式声明Spring Boot父工程：

    org.springframework.boot
    spring-boot-starter-parent
    2.7.18
    

它主要提供以下能力：

1. 统一依赖版本管理

Spring Boot维护了一套经过测试的依赖版本组合，例如：

• Spring Framework；

• Hibernate；

• Jackson；

• Tomcat；

• JUnit；

• Maven插件。

开发者无需手动指定大量版本。

2. 简化Maven配置

继承父工程后，可以直接使用：

    org.springframework.boot
    spring-boot-starter-web

不需要额外填写版本号。

3. 提供默认构建插件

例如：

    org.springframework.boot
    spring-boot-maven-plugin

可以直接完成Spring Boot应用打包。

三、升级前的准备工作

直接修改版本号虽然简单，但大型项目中风险较高。升级前建议做好充分准备。

1. 查看当前项目版本

首先确认当前Spring Boot版本：

2.5.15

同时检查：

• Java版本；

• Maven版本；

• Spring Cloud版本；

• 数据库驱动版本；

• 第三方框架版本。

可以通过命令查看依赖：

mvn dependency:tree

分析当前项目依赖关系。

2. 阅读版本兼容说明

Spring Boot不同版本之间存在兼容要求。

例如：

如果从Spring Boot 2.x升级到3.x，需要提前升级JDK。

3. 创建升级分支

生产项目建议：

git checkout -b upgrade-spring-boot

避免升级失败影响主分支开发。

四、spring-boot-starter-parent版本升级步骤

第一步：修改parent版本

找到pom.xml：

    org.springframework.boot
    spring-boot-starter-parent
    2.7.18

修改为目标版本：

    org.springframework.boot
    spring-boot-starter-parent
    3.3.5

保存后重新加载Maven依赖。

第二步：更新Java版本

Spring Boot 3要求Java 17及以上。

修改：

    17

如果仍然使用Java 8或Java 11，升级后项目无法正常启动。

第三步：检查依赖变化

执行：

mvn clean package

观察编译错误。

常见问题包括：

• API包名变化；

• 方法废弃；

• 配置项调整；

• 第三方依赖不兼容。

五、Spring Boot 2.x升级到3.x重点变化

从2.x升级到3.x是一次较大的版本迁移，需要重点处理以下内容。

1. javax迁移到jakarta

这是最明显的变化。

旧代码：

import javax.servlet.http.HttpServletRequest;

需要修改为：

import jakarta.servlet.http.HttpServletRequest;

类似变化还包括：

javax.persistence

修改为：

jakarta.persistence

大量基于Java EE API的代码都需要调整。

2. Spring Security配置变化

Spring Security 6取消了部分旧配置方式。

例如：

旧版本：

http.authorizeRequests()

新版本：

http.authorizeHttpRequests()

安全配置需要重新检查。

3. Hibernate版本升级

Spring Boot 3默认使用Hibernate 6。

可能影响：

• SQL生成规则；

• 类型映射；

• 自定义方言；

• 查询语句。

数据库相关项目需要重点测试。

六、升级过程中常见问题及解决方法

问题一：Maven依赖冲突

错误表现：

Dependency convergence error

解决方法：

查看依赖树：

mvn dependency:tree

排除冲突依赖：

    
        xxx
        xxx
    

问题二：启动时报Bean创建失败

例如：

BeanCreationException

原因可能包括：

• 自动配置变化；

• 配置属性名称变化；

• 第三方starter不兼容。

建议查看完整异常堆栈，定位最底层cause。

问题三：配置文件失效

Spring Boot升级后部分配置属性可能变化。

例如：

旧配置：

spring.datasource.url

通常仍支持，但部分组件配置名称可能调整。

可以使用官方迁移工具检查：

spring-boot-properties-migrator

辅助发现配置变化。

七、升级后的测试验证

版本升级完成后，不应只验证项目能启动，还需要进行完整测试。

建议检查：

1. 单元测试

执行：

mvn test

确保核心业务逻辑正常。

2. 接口测试

重点测试：

• 登录认证；

• REST接口；

• 文件上传；

• 数据查询；

• 第三方调用。

3. 性能测试

升级后的框架版本可能改变：

• JVM占用；

• SQL执行效率；

• 请求响应时间。

生产环境上线前建议进行压力测试。

八、企业项目升级建议

对于大型系统，不建议一次跨越多个大版本。

推荐路径：

Spring Boot 2.3
        ↓
Spring Boot 2.7
        ↓