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
