Spring Boot 2.7.18 至 3.5.8 版本升级避坑指南
一次跨越主版本的重大升级,从 JDK 8 到 JDK 17,从 javax 到 jakarta,从 Swagger 到 Springdoc… 本文记录了升级过程中的所有关键步骤和避坑指南。
为什么要升级?
Spring Boot 3.0 在 2022 年底正式发布,带来了众多新特性:
- 最低 JDK 17 要求(享受 ZGC、Record、Switch 表达式等新特性)
- Jakarta EE 9+ 迁移(javax → jakarta 包名变更)
- Spring Security 6.0(更安全的默认配置)
- 原生镜像支持(GraalVM 原生编译)
项目从 2.7.18 直升 3.5.8,中间跨越了多个大版本,踩了不少坑。希望这份指南能帮到你。
一、升级前准备
版本选择
text
- OpenJDK 17+(最低要求,推荐 17.0.16 LTS)
- Maven 3.8.6 ~ 3.9.9
- Spring Boot 3.5.8
- Spring Cloud 2025.0.0
- Spring Cloud Alibaba 2025.0.0.0
JDK 17 安装
推荐使用 Eclipse Temurin(原 AdoptOpenJDK):
# 下载地址 https://adoptium.net/zh-CN/temurin/releases?version=17
二、POM 文件改造
1. 父 POM 升级
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.5.8</version>
</parent>
<properties>
<spring-cloud.version>2025.0.0</spring-cloud.version>
<>2025.0.0.0


