Spring Boot 3 升级避坑指南：从审请到上线的完整实战记录

从 Spring Boot 2.x 升级到 3.x 是不少团队今年的重点任务。本文记录了我在实际项目中升级的全过程，以及踩过的那些坑。

为什么升级

• 性能提升：启动速度更快，内存占用更低
• Java 17+ 新特性：可以使用密封类、模式匹配
• 安全性：不再依赖已停止维护的组件

升级步骤

1. 升级 Java 版本

Spring Boot 3 最低要求 Java 17。先确认项目中所有依赖都兼容 Java 17。

2. 依赖全量更新

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.0</version>
</parent>

3. javax 到 jakarta

这是最大的变动。所有 javax.* 包都改成了 jakarta.*。

// 之前
import javax.persistence.*;
// 之后
import jakarta.persistence.*;

踩坑记录

1. Spring Security 配置完全重写
2. 部分第三方 SDK 不兼容，需要找替代方案
3. 配置文件格式微调

总结

升级有风险，提前做好测试环境验证是关键。