尧图网站建设 尧图网络
  • 首页
  • 关于我们
  • 服务项目
  • 案例展示
  • 建站流程
  • 资讯中心
  • 联系我们
首页/资讯中心/详情

JAVA 21 Spring Boot 4 学习--迁移指南 Migration Guide

JAVA 21  Spring Boot 4 学习--迁移指南 Migration Guide
📅 发布时间:2026/6/20 23:32:53

作为 Spring Boot 3.x 之后的首个大版本更新,Spring Boot 4.0 基于 Spring Framework 7.0、Jakarta EE 11 和 Java 17+(推荐 Java 21 或 25),带来了模块化架构重构、虚拟线程原生支持、HTTP 服务客户端自动配置等重大变化。

迁移前准备

升级到最新的3.5.x版本

  1. 官方建议升级 4.x之前,先升级至3.5.x的最新版本,因为这会确保你的项目根据最新的依赖项进行构建
  2. 花时间检查项目中对 deprecated方法的调用,这些将要在4.x版本中删除

review Dependencies【依赖项】

spring boot 4.x更新了大量的依赖项,
可以review 从dependency management for3.5.x到 dependency management for4.0.x的依赖项变化,来评估针对项目的影响

如果你的项目使用了不受Spring Boot管理的依赖项,如Spring Cloud, 则需要升级至兼容的版本

Review System Requirements

  • Spring Boot 4.0需要Java 17+。建议使用最新的Java LTS版本。
  • Spring Boot应用程序也可以使用Kotlin开发,但需要使用v2.2+
  • 如果使用GraalVM native-image,则必须使用Java 25 +
  • Spring Boot 4基于Jakarta EE 11,需要Servlet 6.1基线。
  • 如果您直接管理依赖项,请确保升级至兼容版本

Review Deprecations from Spring Boot 3.x

Spring Boot 3.x中弃用【deprecated】的类、方法、属性在 4.x版本中已经删除。请确保在升级之前没有调用deprecated的方法

升级至 Spring Boot 4

检查完项目及其依赖项的状态后,升级到Spring Boot 4.0的最新维护版本

4.x中被移除的特性

Undertow

因为不兼容Servlet 6.1 baseline,官方不建议将4.x的应用运行在不兼容servlet 6.1的容器中

Pulsar Reactive

在决定移除Spring Pulsar中的反应器支持之后

  • Spring Boot不再管理reactive Pulsar客户端。
  • Spring Pulsar Reactive的自动配置也被移除。

Embedded Executable Uber Jar Launch Scripts

对用于创建“完全可执行【fully executable】”jar文件的嵌入式启动脚本的支持已被删除。这种支持是特定于类unix操作系统的,并且有许多限制

可以使用Spring Boot的构建插件创建uber jars,并使用java -jar运行它们

Spring Session Hazelcast

Spring Session Hazelcast is now under the leadership of the Hazelcast team. As such, direct support for Spring Session Hazelcast has been removed from Spring Boot itself.

Spring Session MongoDB

Spring Session MongoDB is now under the leadership of the MongoDB team. As such, direct support for Spring Session MongoDB has been removed from Spring Boot itself.

Spock集成

Spring Boot的Spock集成已经被删除,因为Spock还没有支持Groovy 5。

模块化架构

Spring Boot 4.0有了新的模块化设计,
Spring Boot 4 将spring-boot-autoconfigure拆分为多个专注的模块,每个技术都有独立的 starter 和对应的测试 starter。

main code变化

  • 模块命名:spring-boot-<technology>
  • 包路径:org.springframework.boot.<technology>
  • Starter 命名:spring-boot-starter-<technology>
  • 之前没有 starter 的技术(如 Flyway、Liquibase)现在需要显式添加对应的 starter

test code变化

  • 模块命名:spring-boot-<technology>-test,
  • 包路径:org.springframework.boot.<technology>-test
  • Test Starter 命名:spring-boot-starter-<technology>和spring-boot-starter-<technology>-test

模块化的优势

  • 减少 IDE 干扰:IDE 自动完成只显示你实际使用的技术相关的类和配置属性,不再出现无关的代码提示。例如,如果你不使用 GraphQL,IDE 不会提示 GraphQL 相关的配置属性
  • 更小的运行时占用:只引入实际使用的模块,减少类路径开销和启动扫描成本。Spring Boot 3.5 的spring-boot-autoconfigure是 2 MiB,模块化后只引入需要的模块,显著减少占用
  • 避免意外自动配置:模块化后,Spring Boot 能更准确地判断你的意图。例如,如果只使用WebClient(通过spring-boot-starter-webclient),不会意外启用 Web 服务器自动配置,不再需要调用SpringApplication.setWebApplicationType(WebApplicationType.NONE)
  • 启用新用例:例如,现在可以独立使用 Micrometer 指标(spring-boot-starter-micrometer-metrics),而不需要完整的 Actuator 依赖链
  • 更好的维护性:模块边界成为明确的契约,而不是软约定,便于团队协作和代码维护

Classic Starter 【快速迁移方案】

如果你正在升级一个现有的应用程序,只是想快速运行,你可以使用“Classic Starter POMs”。classic starter提供了所有模块,但排除了它们所有的可传递依赖。这提供了一个与上一代Spring Boot非常相似的设置,其中所有自动配置类都是可用的。

Previous StarterClassic Equivalent
spring-boot-starterspring-boot-starter-classic

相关新闻

  • Excalidraw呈现用户体验地图:痛点机会点识别
  • Excalidraw呈现组织变革管理:转型过程可视化
  • Excalidraw构建风控规则树:反欺诈策略图示

最新新闻

  • 基于NXP微控制器的ECG心率监测系统:从模拟前端到数字信号处理实战
  • Web安全实战:从SQL注入到WAF绕过,手把手教你靶场攻防
  • [智能体-487]:文明四阶演进脉络:地球碳基文明→数字世界→硅基文明→星际文明
  • 2026年 高达空间节能送风系统推荐榜:高效节能与智能气流调控的全景解析及选购指南 - 品牌发掘
  • 仙桃音响改装难题终结者:音改坊汽车音响旗舰店3大核心优势揭秘,问界音响改装/问界原车音响升级,音响改装门店口碑推荐 - 音响改装门店分享
  • 永康黄金回收报价单位有猫腻吗?克和钱别换算错/金银金包银黄金回收/ 文娟珠宝黄金回收/老金黄金回收 - 回收测评

日新闻

  • Visual C++运行库修复终极指南:5分钟快速解决Windows软件启动错误
  • 手把手教你构建统计局地区经济数据爬虫:从环境搭建到数据持久化全指南
  • 2026多Agent深度解析:用AI团队替代单一模型,四种架构实战落地

周新闻

  • Visual C++运行库修复终极指南:5分钟快速解决Windows软件启动错误
  • 手把手教你构建统计局地区经济数据爬虫:从环境搭建到数据持久化全指南
  • 2026多Agent深度解析:用AI团队替代单一模型,四种架构实战落地

月新闻

  • 【总结】入门篇:50句话让你记住架构核心概念
  • WeChatMsg技术方案解析:实现Mac微信数据自主管理的完整解决方案
  • WeChatMsg:革新性微信数据备份方案,打造你的专属数字记忆库

关于尧图

  • 公司简介
  • 团队介绍
  • 企业文化
  • 荣誉资质

服务项目

  • 定制开发
  • 电商建站
  • UI 设计
  • 运维服务

快速链接

  • 案例展示
  • 建站流程
  • 常见问题
  • 资讯中心

联系方式

  • 📍北京市朝阳区互联网产业园 A 座 10 层
  • 📞400-888-8888
  • ✉️contact@rkmt.cn
  • 🕐周一至周日 9:00-21:00

© 2024 北京尧图网络科技有限公司 版权所有 | 京 ICP 备 XXXXXXXX 号