news 2026/6/10 13:19:05

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
JAVA 21 Spring Boot 4 学习--迁移指南 Migration Guide

作为 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
版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/9 14:59:13

64、Windows命令行工具与脚本自动化全解析

Windows命令行工具与脚本自动化全解析 在Windows系统中,命令行工具是强大的系统操作手段,能帮助用户高效完成各种复杂任务。下面将为大家介绍如何在文件夹中快速打开命令提示符,以及Windows PowerShell的强大功能和脚本自动化的相关知识。 快速打开命令提示符 有两种方法…

作者头像 李华
网站建设 2026/6/10 12:59:54

Excalidraw绘制基因测序流程:生物信息学分析路径

Excalidraw绘制基因测序流程&#xff1a;生物信息学分析路径的可视化革新 在生物信息学实验室里&#xff0c;一个常见的场景是&#xff1a;新加入的研究生盯着PPT中密密麻麻的箭头和工具名发愣——“BWA之后接GATK&#xff1f;中间还要去重&#xff1f;这些步骤到底怎么串起来的…

作者头像 李华
网站建设 2026/6/10 14:15:04

Excalidraw展示数据湖架构:存储与处理一体化

Excalidraw 展示数据湖架构&#xff1a;存储与处理一体化 在今天的大型数据系统设计中&#xff0c;一张清晰的架构图往往比千行文档更有力量。尤其是在构建像数据湖这样横跨存储、计算、元数据管理与多源接入的复杂体系时&#xff0c;如何让团队快速达成共识&#xff0c;成为项…

作者头像 李华
网站建设 2026/6/9 22:35:39

Excalidraw解释Transformer架构:Attention机制详解

Excalidraw 与 Transformer&#xff1a;用“手绘思维”讲清楚 Attention 在 AI 模型变得越来越深、越来越宽的今天&#xff0c;我们似乎陷入了一个矛盾&#xff1a;模型能力在指数级增长&#xff0c;但人类理解它们的能力却远远跟不上。尤其是像 Transformer 这样的架构——它支…

作者头像 李华
网站建设 2026/6/10 10:00:17

80、Windows Media Center使用指南

Windows Media Center使用指南 1. 音乐功能 1.1 查看歌曲列表 查看当前播放队列,还能对队列进行编辑、清空操作,将当前队列保存为播放列表,打乱队列顺序实现随机播放,设置队列自动重复播放。最后还能将播放列表刻录到音频CD或数据CD/DVD,刻录过程与Windows Media Playe…

作者头像 李华
网站建设 2026/6/10 12:39:29

【计算机毕设】PythonB站数据分析可视化系统 (系统配套论文)

&#x1f49f;博主&#xff1a;程序员小俊&#xff1a;CSDN作者、博客专家、全栈领域优质创作者 &#x1f49f; 专注于计算机毕业设计&#xff0c;大数据、深度学习、Java、小程序、python、安卓等技术领域 &#x1f4f2;文章末尾获取源码数据库 &#x1f308;还有大家在毕设选…

作者头像 李华