1. 项目概述Spring Boot 3.x系列作为Java生态的重要里程碑带来了诸多架构级改进。最近我将一个生产环境项目从2.7.18升级到3.5.8整个过程堪称渡劫。不同于小版本迭代这次跨越主版本的升级涉及JDK基线变更、Jakarta EE迁移、依赖链重构等深层次调整任何一个环节处理不当都可能导致应用无法启动。2. 升级前的准备工作2.1 环境兼容性检查Spring Boot 3.x强制要求JDK 17这是第一个需要重点验证的硬性条件。通过java -version确认当前JDK版本如果低于17需要先升级JDK。建议使用JDK 17的LTS版本以获得长期支持。# 检查Java版本 $ java -version openjdk version 17.0.8 2023-07-18 OpenJDK Runtime Environment (build 17.0.87-LTS) OpenJDK 64-Bit Server VM (build 17.0.87-LTS, mixed mode)2.2 依赖项审查使用Maven的dependency:tree命令生成完整的依赖树重点关注直接依赖的Spring生态组件版本第三方库的兼容性声明传递性依赖的潜在冲突!-- 示例检查依赖树 -- plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-dependency-plugin/artifactId version3.6.0/version /plugin执行命令mvn dependency:tree -DoutputFiledependencies.txt3. 核心升级步骤3.1 POM文件改造修改父POM声明为Spring Boot 3.5.8parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version3.5.8/version /parent3.2 Jakarta EE迁移这是最具破坏性的变更。所有javax.*包都需要替换为jakarta.*包括但不限于Servlet APIJPABean ValidationJAXB使用IDE的全局替换功能注意排除测试代码和第三方库javax.persistence - jakarta.persistence javax.servlet - jakarta.servlet javax.validation - jakarta.validation3.3 依赖库适配常见需要特别处理的库SpringDoc OpenAPI需升级到2.xdependency groupIdorg.springdoc/groupId artifactIdspringdoc-openapi-starter-webmvc-ui/artifactId version2.3.0/version /dependency数据库驱动MySQL驱动建议8.0.33PostgreSQL驱动建议42.6.0Spring Securitydependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-security/artifactId /dependency4. 典型问题解决方案4.1 启动类报错现象应用启动时报ClassNotFoundException: javax.servlet.Filter解决方案检查是否漏改启动类注解// 错误示例旧版 ServletComponentScan(basePackages com.example) // 正确写法新版 ServletComponentScan(basePackages com.example)虽然注解名未变但底层实现类已切换到Jakarta包确保web starter使用正确dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency4.2 JPA实体映射异常现象启动时报No identifier specified for entity解决方案检查所有Entity类的主键注解// 旧版 Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; // 新版包路径 import jakarta.persistence.*;验证方言配置spring.jpa.database-platformorg.hibernate.dialect.MySQL8Dialect4.3 测试用例失败现象MockMvc测试报No ServletContext set解决方案更新测试基类注解SpringBootTest AutoConfigureMockMvc public class ControllerTest { Autowired private MockMvc mockMvc; }检查Security测试配置WithMockUser(usernameadmin, roles{ADMIN}) public void testAdminEndpoint() throws Exception { mockMvc.perform(get(/admin)) .andExpect(status().isOk()); }5. 升级后验证策略5.1 分层测试方案单元测试确保业务逻辑不变mvn testAPI测试验证Controller层响应mvn spring-boot:start # 使用Postman执行测试集合集成测试检查数据库事务、消息队列等集成点5.2 性能基准对比使用JMeter对关键接口进行压测对比升级前后的平均响应时间错误率吞吐量典型指标要求错误率 0.1%性能衰减 15%6. 回滚预案尽管做了充分测试生产环境仍需准备回滚方案代码回滚git revert commit_hash数据库备份mysqldump -u root -p mydb backup_$(date %F).sql配置管理保留旧版application.properties记录当前运行的JVM参数7. 持续集成适配更新CI/CD流水线配置Jenkinsfile示例pipeline { agent any tools { jdk jdk17 maven maven-3.9.6 } stages { stage(Build) { steps { sh mvn clean package -DskipTests } } } }Docker镜像调整FROM eclipse-temurin:17-jdk-jammy COPY target/*.jar app.jar ENTRYPOINT [java,-jar,/app.jar]8. 升级后的优化方向成功升级后可考虑以下改进GraalVM原生镜像plugin groupIdorg.graalvm.buildtools/groupId artifactIdnative-maven-plugin/artifactId version0.9.28/version /pluginJDK 21特性虚拟线程Loom项目序列化集合字符串模板Spring Boot 3.2新特性增强的缓存管理改进的Micrometer观测CRaC支持关键提示升级过程中建议建立checklist每完成一个模块立即验证避免问题堆积。遇到编译错误时优先解决包路径问题javax→jakarta这类错误通常有连锁反应。