SpringBoot 3.x新特性全面解析：从Java 17支持到GraalVM原生镜像

SpringBoot 3.x新特性全面解析：从Java 17支持到GraalVM原生镜像

前言

Spring Boot 3.x 是 Spring 框架的又一重大版本升级，带来了诸多令人兴奋的新特性。它不仅全面支持 Java 17，还引入了对 GraalVM 原生镜像的深度集成，开启了 Java 应用性能优化的新篇章。 此次升级不仅仅是简单的功能迭代，更是对底层架构的一次彻底革新。基于 Spring Framework 6.x 和 Jakarta EE 9/10 基础，Spring Boot 3.x 为云原生时代的企业级 Java 开发奠定了坚实基础。 本文将结合 Mermaid 流程图，全面解析 Spring Boot 3.x 的新特性，从 Java 17 支持到 GraalVM 原生镜像，助你掌握这一版本的核心亮点。

一、 Spring Boot 3.x 概述

Spring Boot 3.x 是 Spring 框架的第三个主要版本，于 2022 年底发布。它的诞生标志着 Spring 生态正式全面拥抱现代 Java 技术栈和云原生标准。

1.1 核心特性

• Java 17 基线：全面支持 Java 17，并完美适配 Java 19 和 20，利用现代 JVM 特性。
• Jakarta EE 9/10：包名从 javax.* 迁移至 jakarta.*，解决了多年的命名空间历史包袱。
• GraalVM 原生镜像：深度集成 GraalVM，提供了一流的 Native Image 支持，实现毫秒级启动。
• 观测性升级：内置 Micrometer Tracing，简化了分布式链路追踪的集成。
• AOT (Ahead-of-Time) 编译：引入 AOT 转换引擎，为原生镜像提供优化支持。

1.2 版本对比

为了更直观地展示升级带来的变化，我们通过下表对比 Spring Boot 2.x 和 3.x 的核心差异：

二、 基石变更：Java 17 与 Jakarta EE

Spring Boot 3.x 的构建基础发生了根本性变化，这是迁移过程中最需要注意的部分。

2.1 Java 17 带来的红利

将最低版本要求提升至 Java 17，意味着开发者可以直接利用现代 Java 语言的特性，编写更简洁、更高效的代码。 关键特性应用：

• Records：作为不可变数据载体，完美替代传统的 POJO，极大地减少了 DTO 和 Entity 的样板代码。
• Sealed Classes：用于限制继承层次结构，使得领域模型设计更加严谨。
• Switch 表达式：简化多条件判断逻辑。
• Text Blocks：在编写复杂 SQL 或 JSON 字符串时，保持代码格式整洁。

2.2 从 javax 到 jakarta

这是 Spring Boot 3.x 最具破坏性的变更。为了支持 Jakarta EE 标准，所有的包名都发生了变化。这意味着，如果你的项目依赖了旧版 javax.persistence 或 javax.servlet 的第三方库，必须升级到支持 Jakarta EE 的版本。 迁移流程图：

#mermaid-svg-5aiy8MtNIkU4jNQG{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-5aiy8MtNIkU4jNQG .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-5aiy8MtNIkU4jNQG .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-5aiy8MtNIkU4jNQG .error-icon{fill:#552222;}#mermaid-svg-5aiy8MtNIkU4jNQG .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-5aiy8MtNIkU4jNQG .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-5aiy8MtNIkU4jNQG .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-5aiy8MtNIkU4jNQG .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-5aiy8MtNIkU4jNQG .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-5aiy8MtNIkU4jNQG .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-5aiy8MtNIkU4jNQG .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-5aiy8MtNIkU4jNQG .marker{fill:#333333;stroke:#333333;}#mermaid-svg-5aiy8MtNIkU4jNQG .marker.cross{stroke:#333333;}#mermaid-svg-5aiy8MtNIkU4jNQG svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-5aiy8MtNIkU4jNQG p{margin:0;}#mermaid-svg-5aiy8MtNIkU4jNQG .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-5aiy8MtNIkU4jNQG .cluster-label text{fill:#333;}#mermaid-svg-5aiy8MtNIkU4jNQG .cluster-label span{color:#333;}#mermaid-svg-5aiy8MtNIkU4jNQG .cluster-label span p{background-color:transparent;}#mermaid-svg-5aiy8MtNIkU4jNQG .label text,#mermaid-svg-5aiy8MtNIkU4jNQG span{fill:#333;color:#333;}#mermaid-svg-5aiy8MtNIkU4jNQG .node rect,#mermaid-svg-5aiy8MtNIkU4jNQG .node circle,#mermaid-svg-5aiy8MtNIkU4jNQG .node ellipse,#mermaid-svg-5aiy8MtNIkU4jNQG .node polygon,#mermaid-svg-5aiy8MtNIkU4jNQG .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-5aiy8MtNIkU4jNQG .rough-node .label text,#mermaid-svg-5aiy8MtNIkU4jNQG .node .label text,#mermaid-svg-5aiy8MtNIkU4jNQG .image-shape .label,#mermaid-svg-5aiy8MtNIkU4jNQG .icon-shape .label{text-anchor:middle;}#mermaid-svg-5aiy8MtNIkU4jNQG .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-5aiy8MtNIkU4jNQG .rough-node .label,#mermaid-svg-5aiy8MtNIkU4jNQG .node .label,#mermaid-svg-5aiy8MtNIkU4jNQG .image-shape .label,#mermaid-svg-5aiy8MtNIkU4jNQG .icon-shape .label{text-align:center;}#mermaid-svg-5aiy8MtNIkU4jNQG .node.clickable{cursor:pointer;}#mermaid-svg-5aiy8MtNIkU4jNQG .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-5aiy8MtNIkU4jNQG .arrowheadPath{fill:#333333;}#mermaid-svg-5aiy8MtNIkU4jNQG .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-5aiy8MtNIkU4jNQG .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-5aiy8MtNIkU4jNQG .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-5aiy8MtNIkU4jNQG .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-5aiy8MtNIkU4jNQG .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-5aiy8MtNIkU4jNQG .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-5aiy8MtNIkU4jNQG .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-5aiy8MtNIkU4jNQG .cluster text{fill:#333;}#mermaid-svg-5aiy8MtNIkU4jNQG .cluster span{color:#333;}#mermaid-svg-5aiy8MtNIkU4jNQG div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-5aiy8MtNIkU4jNQG .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-5aiy8MtNIkU4jNQG rect.text{fill:none;stroke-width:0;}#mermaid-svg-5aiy8MtNIkU4jNQG .icon-shape,#mermaid-svg-5aiy8MtNIkU4jNQG .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-5aiy8MtNIkU4jNQG .icon-shape p,#mermaid-svg-5aiy8MtNIkU4jNQG .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-5aiy8MtNIkU4jNQG .icon-shape rect,#mermaid-svg-5aiy8MtNIkU4jNQG .image-shape rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-5aiy8MtNIkU4jNQG .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-5aiy8MtNIkU4jNQG .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-5aiy8MtNIkU4jNQG :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

是

否

否

是

Spring Boot 2.x 应用

代码中包含 javax 引用?

批量替换包名 javax -> jakarta

检查依赖兼容性

依赖库支持 Jakarta EE?

升级依赖库版本

构建并运行 Spring Boot 3.x

三、 GraalVM 原生镜像：性能的飞跃

GraalVM 原生镜像技术是 Spring Boot 3.x 皇冠上的明珠。它允许将 Java 应用程序编译成一个独立的本地可执行文件，该文件包含应用程序代码、所需库、运行时以及静态链接的原生代码。

3.1 原生镜像原理

传统的 Java 应用运行在 JVM 上，采用 JIT (Just-In-Time) 编译，虽然经过预热后性能极高，但启动慢、内存占用大。而 GraalVM Native Image 采用 AOT 编译，在构建阶段就将代码编译为机器码。

#mermaid-svg-tnUfVQrt0S68SKur{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-tnUfVQrt0S68SKur .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-tnUfVQrt0S68SKur .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-tnUfVQrt0S68SKur .error-icon{fill:#552222;}#mermaid-svg-tnUfVQrt0S68SKur .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-tnUfVQrt0S68SKur .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-tnUfVQrt0S68SKur .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-tnUfVQrt0S68SKur .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-tnUfVQrt0S68SKur .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-tnUfVQrt0S68SKur .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-tnUfVQrt0S68SKur .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-tnUfVQrt0S68SKur .marker{fill:#333333;stroke:#333333;}#mermaid-svg-tnUfVQrt0S68SKur .marker.cross{stroke:#333333;}#mermaid-svg-tnUfVQrt0S68SKur svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-tnUfVQrt0S68SKur p{margin:0;}#mermaid-svg-tnUfVQrt0S68SKur .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-tnUfVQrt0S68SKur .cluster-label text{fill:#333;}#mermaid-svg-tnUfVQrt0S68SKur .cluster-label span{color:#333;}#mermaid-svg-tnUfVQrt0S68SKur .cluster-label span p{background-color:transparent;}#mermaid-svg-tnUfVQrt0S68SKur .label text,#mermaid-svg-tnUfVQrt0S68SKur span{fill:#333;color:#333;}#mermaid-svg-tnUfVQrt0S68SKur .node rect,#mermaid-svg-tnUfVQrt0S68SKur .node circle,#mermaid-svg-tnUfVQrt0S68SKur .node ellipse,#mermaid-svg-tnUfVQrt0S68SKur .node polygon,#mermaid-svg-tnUfVQrt0S68SKur .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-tnUfVQrt0S68SKur .rough-node .label text,#mermaid-svg-tnUfVQrt0S68SKur .node .label text,#mermaid-svg-tnUfVQrt0S68SKur .image-shape .label,#mermaid-svg-tnUfVQrt0S68SKur .icon-shape .label{text-anchor:middle;}#mermaid-svg-tnUfVQrt0S68SKur .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-tnUfVQrt0S68SKur .rough-node .label,#mermaid-svg-tnUfVQrt0S68SKur .node .label,#mermaid-svg-tnUfVQrt0S68SKur .image-shape .label,#mermaid-svg-tnUfVQrt0S68SKur .icon-shape .label{text-align:center;}#mermaid-svg-tnUfVQrt0S68SKur .node.clickable{cursor:pointer;}#mermaid-svg-tnUfVQrt0S68SKur .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-tnUfVQrt0S68SKur .arrowheadPath{fill:#333333;}#mermaid-svg-tnUfVQrt0S68SKur .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-tnUfVQrt0S68SKur .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-tnUfVQrt0S68SKur .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-tnUfVQrt0S68SKur .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-tnUfVQrt0S68SKur .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-tnUfVQrt0S68SKur .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-tnUfVQrt0S68SKur .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-tnUfVQrt0S68SKur .cluster text{fill:#333;}#mermaid-svg-tnUfVQrt0S68SKur .cluster span{color:#333;}#mermaid-svg-tnUfVQrt0S68SKur div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-tnUfVQrt0S68SKur .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-tnUfVQrt0S68SKur rect.text{fill:none;stroke-width:0;}#mermaid-svg-tnUfVQrt0S68SKur .icon-shape,#mermaid-svg-tnUfVQrt0S68SKur .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-tnUfVQrt0S68SKur .icon-shape p,#mermaid-svg-tnUfVQrt0S68SKur .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-tnUfVQrt0S68SKur .icon-shape rect,#mermaid-svg-tnUfVQrt0S68SKur .image-shape rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-tnUfVQrt0S68SKur .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-tnUfVQrt0S68SKur .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-tnUfVQrt0S68SKur :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

运行阶段

构建阶段

Java 源码

Spring AOT 引擎

GraalVM Native Image构建

原生可执行文件

直接运行无 JVM 启动开销

极快启动速度低内存占用

关键组件解析：

3.2 实战示例：构建原生镜像

在 Spring Boot 3.x 中，构建原生镜像变得前所未有的简单。

优势总结：

• 启动速度：从传统的数秒缩短至 毫秒级，非常适合 Serverless 和微服务架构。
• 内存占用：无需 JVM 堆内存管理，内存占用大幅降低，适合高密度容器部署。
• 即时性能：没有 JIT 预热过程，启动即达到最高性能。

四、 可观测性升级：Micrometer Tracing

在微服务架构中，链路追踪至关重要。Spring Boot 3.x 废弃了 Spring Cloud Sleuth，转而全面拥抱 Micrometer Tracing。

4.1 新的观测架构

Micrometer 提供了与各种可观测性后端（如 Zipkin, Prometheus, Wavefront）的无缝集成，且 API 设计更加现代化。

Observability Backend (Jaeger/Zipkin)

OTLP Exporter

Micrometer Tracing

Spring Boot 3.x App

Client

Observability Backend (Jaeger/Zipkin)

OTLP Exporter

Micrometer Tracing

Spring Boot 3.x App

Client

#mermaid-svg-oEyfrt1TxqbEDSFC{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-oEyfrt1TxqbEDSFC .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-oEyfrt1TxqbEDSFC .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-oEyfrt1TxqbEDSFC .error-icon{fill:#552222;}#mermaid-svg-oEyfrt1TxqbEDSFC .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-oEyfrt1TxqbEDSFC .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-oEyfrt1TxqbEDSFC .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-oEyfrt1TxqbEDSFC .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-oEyfrt1TxqbEDSFC .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-oEyfrt1TxqbEDSFC .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-oEyfrt1TxqbEDSFC .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-oEyfrt1TxqbEDSFC .marker{fill:#333333;stroke:#333333;}#mermaid-svg-oEyfrt1TxqbEDSFC .marker.cross{stroke:#333333;}#mermaid-svg-oEyfrt1TxqbEDSFC svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-oEyfrt1TxqbEDSFC p{margin:0;}#mermaid-svg-oEyfrt1TxqbEDSFC .actor{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-oEyfrt1TxqbEDSFC text.actor>tspan{fill:black;stroke:none;}#mermaid-svg-oEyfrt1TxqbEDSFC .actor-line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-oEyfrt1TxqbEDSFC .innerArc{stroke-width:1.5;stroke-dasharray:none;}#mermaid-svg-oEyfrt1TxqbEDSFC .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#333;}#mermaid-svg-oEyfrt1TxqbEDSFC .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#333;}#mermaid-svg-oEyfrt1TxqbEDSFC #arrowhead path{fill:#333;stroke:#333;}#mermaid-svg-oEyfrt1TxqbEDSFC .sequenceNumber{fill:white;}#mermaid-svg-oEyfrt1TxqbEDSFC #sequencenumber{fill:#333;}#mermaid-svg-oEyfrt1TxqbEDSFC #crosshead path{fill:#333;stroke:#333;}#mermaid-svg-oEyfrt1TxqbEDSFC .messageText{fill:#333;stroke:none;}#mermaid-svg-oEyfrt1TxqbEDSFC .labelBox{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-oEyfrt1TxqbEDSFC .labelText,#mermaid-svg-oEyfrt1TxqbEDSFC .labelText>tspan{fill:black;stroke:none;}#mermaid-svg-oEyfrt1TxqbEDSFC .loopText,#mermaid-svg-oEyfrt1TxqbEDSFC .loopText>tspan{fill:black;stroke:none;}#mermaid-svg-oEyfrt1TxqbEDSFC .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-oEyfrt1TxqbEDSFC .note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-svg-oEyfrt1TxqbEDSFC .noteText,#mermaid-svg-oEyfrt1TxqbEDSFC .noteText>tspan{fill:black;stroke:none;}#mermaid-svg-oEyfrt1TxqbEDSFC .activation0{fill:#f4f4f4;stroke:#666;}#mermaid-svg-oEyfrt1TxqbEDSFC .activation1{fill:#f4f4f4;stroke:#666;}#mermaid-svg-oEyfrt1TxqbEDSFC .activation2{fill:#f4f4f4;stroke:#666;}#mermaid-svg-oEyfrt1TxqbEDSFC .actorPopupMenu{position:absolute;}#mermaid-svg-oEyfrt1TxqbEDSFC .actorPopupMenuPanel{position:absolute;fill:#ECECFF;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#mermaid-svg-oEyfrt1TxqbEDSFC .actor-man line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-oEyfrt1TxqbEDSFC .actor-man circle,#mermaid-svg-oEyfrt1TxqbEDSFC line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;stroke-width:2px;}#mermaid-svg-oEyfrt1TxqbEDSFC :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

自动记录耗时、标签、异常

发送 HTTP 请求

创建 Span

执行业务逻辑

关闭 Span

发送 Trace 数据

上报

返回响应

实战配置： 只需引入对应的依赖，即可自动开启链路追踪。

<dependency>
<groupId>io.micrometer</groupId>
<artifactId>micrometer-tracing-bridge-brave</artifactId>
</dependency>
<dependency>
<groupId>io.zipkin.reporter2</groupId>
<artifactId>zipkin-reporter-brave</artifactId>
</dependency>

五、 其他重要新特性

除了上述核心亮点，Spring Boot 3.x 在细节上也进行了大量优化。

5.1 属性文件变更

• YAML 格式升级：不再支持 .yml 文件中包含换行符的多行字符串（使用 | 或 > 除外），以更好地符合 YAML 规范。
• 环境变量前缀：对绑定到环境变量的属性前缀进行了改进，处理方式更加灵活。

5.2 安全性增强

• Spring Security 6.x：默认不再创建安全过滤器链，需要开发者显式配置，迫使开发者明确安全策略。
• 配置属性迁移：许多安全相关的配置属性（如 security.basic.enabled）被移除，推荐使用组件式配置。

5.3 Docker 镜像构建

官方提供了 paketobuildpacks/builder，并默认开启对 CNB (Cloud Native Buildpacks) 的支持，构建更加透明和标准化。

# 使用 Buildpacks 构建镜像
mvn spring-boot:build-image

六、 迁移实战指南

从 Spring Boot 2.x 迁移到 3.x 是一个系统工程，建议遵循以下步骤。

6.1 迁移流程图

渲染错误: Mermaid 渲染失败: Parse error on line 12: …> K[构建 Native Image (可选)] K –> L[部署 ———————–^ Expecting 'SQE', 'DOUBLECIRCLEEND', 'PE', '-)', 'STADIUMEND', 'SUBROUTINEEND', 'PIPE', 'CYLINDEREND', 'DIAMOND_STOP', 'TAGEND', 'TRAPEND', 'INVTRAPEND', 'UNICODE_TEXT', 'TEXT', 'TAGSTART', got 'PS'

6.2 常见问题排查

七、 总结

Spring Boot 3.x 是一次承前启后的版本升级。它不仅清理了 Jakarta EE 历史包袱，通过 Java 17 带来了语言层面的红利，更重要的是，它通过 GraalVM Native Image 真正将 Java 带入了云原生高性能竞赛的跑道。 对于开发者而言，虽然迁移过程（尤其是 javax 到 jakarta）会有阵痛，但换来的是更现代的开发体验、更快的启动速度和更低的资源消耗。无论是开发微服务、Serverless 应用，还是传统的企业级应用，Spring Boot 3.x 都是目前最优的选择。 关键点回顾：