Spring Boot 5.0 不存在，截至2026年8月6日最新正式版是4.0.3（2025年11月20日发布），所有“5.0”表述均属误传；强行使用将导致Maven解析失败、编译中断。
Spring Boot 5.0 尚未发布，截至2026年8月6日，Spring Boot 最新正式版本为 4.0.3（发布于2025年11月20日），官方路线图与Spring Framework 7.x深度绑定，无Spring Boot 5.0规划。当前所有声称“Spring Boot 5.0”的文档、依赖坐标或Starter包均属虚构、误传或非官方预研分支。强行按“5.0”升级将导致依赖坐标解析失败、Maven中央仓库查无此版本、IDE报红且无法构建。
确认当前真实可用的最高稳定版本
打开 https://spring.io/projects/spring-boot#learn → 查看 “Current GA Release” 栏位 → 明确显示为 4.0.3（发布日期：2025-11-20）。
执行命令验证本地仓库实际可用版本：mvn versions:display-dependency-updates -DincludeGroupId=org.springframework.boot → 输出中最高合法 version 字段不会超过 4.0.3。
若 pom.xml 中出现 <version>5.0.0</version> 或类似写法，【Maven将彻底拒绝解析该依赖，编译直接中断】，必须立即修正。
Starter 升级到 Spring Boot 4.0.3 的实操路径
第一步：将 parent 版本从 3.x 改为 4.0.3
在 pom.xml 的 <parent> 块中，把 <version> 替换为 4.0.3；不要写成 5.0.0、4.1.0 或 4.0.3.RELEASE（后者已废弃命名规范）。
第二步：删除显式声明的 starter 依赖版本号
Spring Boot 4.0.3 的 starter（如 spring-boot-starter-web）不再需要在 <dependency> 内写 <version> —— 所有 starter 版本均由 parent 的 BOM 统一锁定；手动指定版本会破坏自动兼容性校验，引发 Jakarta EE 11 与旧 Jakarta API 混用冲突。
第三步：检查并替换 Jakarta 命名空间引用
全局搜索项目中所有 javax.* 包导入（如 javax.servlet.http.HttpServletRequest），全部替换为对应 jakarta.*（例：jakarta.servlet.http.HttpServletRequest）；Spring Boot 4.0 要求 Jakarta EE 11，【保留 javax 导入会导致编译失败且无法启动】。
兼容性迁移关键动作清单
方法一：自动配置模块化适配
Spring Boot 4.0 将 autoconfigure 拆分为 47 个独立模块，引入 spring-boot-starter-data-jpa 不再隐式拉入 spring-boot-starter-batch；若代码中使用了 Batch 相关类但未声明 batch starter，则编译报错——此时必须显式添加 spring-boot-starter-batch 依赖，不能依赖“以前有现在还有”的惯性思维。
方法二：空安全注解迁移
删除所有 @NonNull、@Nullable 来自 org.springframework.lang 的导入；改用 JSpecify 1.0 注解：import org.jspecify.annotations.NullMarked; 和 @NullUnmarked；IDE 需安装 JSpecify 插件才能识别校验规则，否则编译期空检查失效。
方法三：虚拟线程启用控制
在 application.yml 中添加：spring.threads.virtual.enabled: true；此项默认关闭，不显式开启则无法享受 Spring Boot 4.0 的虚拟线程调度红利；注意 JDK 必须为 21+（推荐 25 或 26），JDK 17 下开启该配置将静默忽略。
