← 课程目录 🚀 从零到一
📐 学习维度 阶段4 · 第14章 Spring Boot 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

14.4 Spring Boot 3.x 迁移指南:javax 到 jakarta

审校 2026-09-25 · 素材来源:2026真题_16、2026前沿热点速查_03
📑 本篇章节导航 (共7节,点击直达)
迁移三座大山迁移操作五步升级买什么:三样新能力迁不迁:决策框架踩坑清单面试怎么问一句话总结

老项目升 Boot 3,一启动满屏 ClassNotFoundException: javax.servlet.*——这不是 Bug,是 Java 生态的一次改朝换代。2026 年面试的新增高频区:Boot 3 迁移改了什么、为什么改、迁还是不迁。这一篇把账算清。

迁移三座大山

第一座:javax → jakarta。Eclipse 基金会接手 Java EE 后协议不允许继续用 javax 命名空间,整套 API 搬家改姓 jakarta:javax.servlet 变 jakarta.servlet,注解、校验、持久化 API 全部跟进。业务代码里 import 批量替换即可,真正痛的是第三方库——老版本的字节码里写死了 javax,只能等它发新版本或换库。背景补一句就懂为何无缓冲余地:Oracle 把 Java EE 捐给 Eclipse 时签的协议里,javax 命名空间的所有权仍在 Oracle 手里,新治理下的代码不许往别人的包里加东西——想继续演进,只剩改名一条路。这不是技术决策是法律约束,所以不存在「再等一等说不定不改了」的侥幸。

第二座:Java 17 基线。Boot 3 要求最低 Java 17,不再支持 8 和 11。项目还在 Java 8 的,先过升级 JDK 这关(涉及框架特性、GC 行为、许可证评估),再谈 Boot。顺带的收益是 Records、密封类、文本块这些语言特性放开用。注意升级顺序别倒:先 JDK 后框架——先升 Boot 会直接卡在基线检查,先升 JDK 则老 Boot 照样能跑(Boot 2.7 支持 17),应用可以分两步各自验证,每步都有回退点。

第三座:配 Three 件套。Spring Framework 6 底座、Jakarta EE 9+、可观测性 Micrometer 新抽象。配置属性改名一批(如 spring.redis.* 改 spring.data.redis.*),升级时要对照官方迁移清单逐项过。改名的逻辑值得看一眼:不是随机折腾,而是把「中间件归属」归位——Redis、MongoDB、Elasticsearch 统统挪进 spring.data.* 命名空间,配置树与其生态结构对齐,长期看是良性整理,短期看是迁移工作量。

迁移操作五步


① 升 JDK 到 17,跑全量回归
② 升 Boot 到 3.x(用 spring-boot-properties-migrator 提示属性改名)
③ 全局替换 javax→jakarta(IDE 批量 + 编译器兜底)
④ 盘点第三方依赖:不兼容的升级或替换
⑤ 重跑 CI 与压测,对照性能基线

排雷清单挑高频的说:Swagger 老版 springfox 已死,换 springdoc-openapi;HikariCP、MyBatis、Redis 客户端要用支持 jakarta 的版本;自研的 Servlet 过滤器、监听器全要改 import。经验值:中小项目一两天,重度依赖老库的按周计。工具面上有两件趁手的:OpenRewrite(自动改写源码的重构工具)能批量完成 javax→jakarta 替换和属性改名,一条命令省掉八成体力活;spring-boot-properties-migrator(属性迁移提示依赖)临时挂上后,启动时会为每个改名属性打 WARN 并说明新写法——跑一次启动日志,属性改名的账就全列出来了,迁完记得移除,别让它常驻生产。

升级买什么:三样新能力

虚拟线程(JDK 21 的轻量级线程,阻塞 IO 不占 OS 线程):Boot 3.2+ 一行 spring.threads.virtual.enabled=true 开启,Tomcat 每个请求跑在虚拟线程上——高并发 IO 密集场景吞吐显著涨,代码零改动。两个注意:CPU 密集任务无收益;重依赖 ThreadLocal 的代码要防内存膨胀(百万虚拟线程各带一份副本)。还要认识一个新坑:钉住(pinning)——JDK 21 里 synchronized 块内阻塞会让虚拟线程钉在载体线程上,并发一高又退回老问题;JDK 24 已把 synchronized 的钉住解决,但老代码里大量嵌套锁的场景,上线前要压测验证而不是想当然。


spring:
  threads:
    virtual:
      enabled: true      # Tomcat/异步任务全切虚拟线程

原理直觉(7.6 讲过线程与阻塞的成本):平台线程是 1:1 映射 OS 线程的贵重资源,虚拟线程由 JVM 调度、遇阻塞就让出载体线程——「用完即还」的租赁模型对 IO 等待天然友好。所以它的收益曲线很清晰:接口越是在「等数据库、等下游 HTTP」上耗时间,切换越划算。

GraalVM 原生镜像(AOT 编译,直接产本地机器码):启动从秒级降到约百毫秒,内存省一大截,Serverless 和 CLI 的福音。代价也硬:反射要提前注册、动态代理受限、编译耗时几分钟。Spring 6 配合 AOT 引擎把大部分反射预处理掉了,但第三方库的坑还在。评估口径:启动速度敏感选它,长期服务跑 JVM 更稳。

可观测性增强:Micrometer Observation 一套 API 同时产出指标、链路、日志关联(16.6 的链路追踪直接受益);3.3 起还有结构化日志,一行配置输出 JSON,免装编码器插件。

迁不迁:决策框架

不是所有项目都该立刻迁。该迁的信号:需要虚拟线程或原生镜像的红利、依赖的生态已停更 2.x、公司要统一技术栈。可以先缓的场景:系统稳定无新需求、核心依赖无 jakarta 版本、JDK 8 升级牵一发动全身。折中路线:新项目直接 Boot 3 起步,存量按「依赖就绪一个迁一个」排期——一刀切的全民迁移,多半是给排障埋雷。还有个隐性成本要提前给老板打预防针:迁移的收益多是「能力储备」(新特性可用、生态不脱队),而不是立竿见影的业务提速——把它当技术债清理排期,别当性能优化立项,期望管理做对了,验收才不打架。

踩坑清单

面试怎么问

一句话总结

Boot 3 迁移的本质是 Java EE 改姓 jakarta 的生态跟进——短期是 import 替换的体力活,长期买的是虚拟线程、原生镜像和统一可观测性三张新船票。