引言

Spring Boot 3.x 是一次里程碑式的升级，要求 Java 17 基线，全面拥抱 Jakarta EE 9+，并引入了AOT 编译与原生镜像、虚拟线程、增强的可观测性等杀手级特性。这些变化不仅提升了应用性能，更彻底改变了开发与部署模式。本文将带你逐一解锁这些核心能力，并提供可直接运行的代码示例。

一、核心概念速览

1.1 基线升级：Java 17 与 Jakarta EE 9

Spring Boot 3.x 将 Java 版本强制提升至 17，这意味着你可以直接使用 Records、Sealed Classes、Pattern Matching 等现代语法。同时，从 javax.* 迁移到 jakarta.* 是最大 breaking change，所有依赖 Spring 的第三方库也必须同步升级，否则启动即报错。

1.2 AOT 编译与原生镜像（GraalVM）

AOT（Ahead-of-Time）编译可以在构建时完成大部分初始化工作，生成可直接运行的二进制文件，配合 GraalVM Native Image 可实现毫秒级启动、极低内存占用，特别适合 Serverless 和容器化场景。Spring Boot 3.x 提供了完整的 AOT 引擎，能自动分析你的 Bean 定义并生成编译提示。

1.3 虚拟线程（Project Loom）

Java 19/21 引入的虚拟线程是协程的轻量级实现，能让你用同步方式编写代码却获得异步的性能。Spring Boot 3.2+ 内置了对虚拟线程的支持，只需简单配置，Tomcat、Jetty 等容器的请求处理线程就会全部变为虚拟线程，极大提升高并发场景的吞吐量。

1.4 第一流可观测性

新版本通过 Micrometer 与 Micrometer Tracing 统一了指标、日志、链路追踪，内置支持 OpenTelemetry 和 Zipkin。你只需引入 starter，即可自动生成 Span、TraceId 并导出到后端，让分布式调试变得前所未有简单。

二、实战示例：构建一个原生镜像支持的 REST 服务

下面我们通过一个完整的项目演示如何使用 Spring Boot 3.x 构建 REST 接口，并编译为原生可执行文件。环境要求：JDK 17+、GraalVM 22.3+（含 native-image 组件）、Maven 3.8+。

2.1 项目初始化

使用 Spring Initializr 创建项目，选择：

• Spring Boot 版本：3.2.5
• 依赖：Spring Web, GraalVM Native Support, Spring Boot Actuator, Spring Data JPA, H2 Database

生成的 pom.xml 包含 AOT 和 native 相关插件。注意添加 --enable-url-protocols=http 等 native 配置参数。关键依赖如下：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-aop</artifactId>
    </dependency>
</dependencies>

2.2 实体、仓库与控制器

创建 Book 实体，使用 Record 简化（也可以使用传统类，这里演示 Java 17 特性）：

// Book.java
import jakarta.persistence.*;

@Entity
public class Book {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String title;
    private String author;

    public Book() {}

    public Book(String title, String author) {
        this.title = title;
        this.author = author;
    }

    // getters and setters...

    @Override
    public String toString() {
        return "Book{id=%d, title='%s', author='%s'}".formatted(id, title, author);
    }
}

Repository 使用 Spring Data JPA：

// BookRepository.java
import org.springframework.data.jpa.repository.JpaRepository;

public interface BookRepository extends JpaRepository<Book, Long> {
}

控制器提供 CRUD 端点：

// BookController.java
import org.springframework.web.bind.annotation.*;
import java.util.List;

@RestController
@RequestMapping("/books")
public class BookController {
    private final BookRepository repo;

    public BookController(BookRepository repo) {
        this.repo = repo;
    }

    @GetMapping
    public List<Book> list() {
        return repo.findAll();
    }

    @PostMapping
    public Book create(@RequestBody Book book) {
        return repo.save(book);
    }
}

2.3 启用虚拟线程

只需在配置文件中加入：

# application.yml
spring:
  threads:
    virtual:
      enabled: true

Spring Boot 3.2+ 会自动将内嵌 Tomcat 的请求处理线程替换为虚拟线程。你可以在控制器中通过 Thread.currentThread().isVirtual() 验证。当然，必须运行在 Java 21+ 环境下，否则配置会被忽略。

2.4 可观测性集成

引入 spring-boot-starter-actuator 和 micrometer-tracing-bridge-otel（需手动添加），配置导出到 Zipkin：

<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-tracing-bridge-otel</artifactId>
</dependency>
<dependency>
    <groupId>io.opentelemetry</groupId>
    <artifactId>opentelemetry-exporter-zipkin</artifactId>
</dependency>

application.yml 配置：

management:
  tracing:
    sampling:
      probability: 1.0
  zipkin:
    tracing:
      endpoint: http://localhost:9411/api/v2/spans

启动后访问 /books，会在日志看到 TraceId 和 SpanId，Zipkin UI 中也能看到完整调用链。

2.5 AOT 与原生镜像构建

首先执行 AOT 预处理，生成编译所需元数据：

mvn -Pnative spring-boot:process-aot

然后构建原生镜像（需要 GraalVM 环境）：

mvn -Pnative native:compile

成功后会在 target 下生成可执行文件，启动速度令人惊叹：

./target/spring-boot-native-demo
# 启动时间通常 < 0.1 秒

此时你的应用就是一个完全自包含的二进制文件，无需 JVM，在 Docker 中的镜像大小可压缩到几十 MB。

三、常见问题与注意事项

3.1 第三方库兼容性

由于 javax.* → jakarta.* 的迁移，大量老旧的依赖无法直接使用。务必检查所有 starter 是否发布了 Jakarta EE 9+ 兼容版本。例如旧版 MyBatis、Swagger 2 等必须替换为对应新版本。遇到 ClassNotFoundException: javax.servlet.Filter 这类错误时，第一时间升级相关依赖。

3.2 原生镜像的动态特性限制

原生编译是封闭世界假设，所有反射、动态代理、资源加载必须在编译期声明。Spring Boot AOT 能自动处理大部分 Bean 定义，但如果你的代码使用了大量反射、Groovy 脚本、JMX 等，则需要通过 @RegisterReflectionForBinding、RuntimeHintsRegistrar 等机制主动注册提示。JPA、Jackson 等框架也需要额外提示文件，Spring Boot 的 native 支持已内置大部分，但仍需关注启动时的 unknown hints 警告。

3.3 虚拟线程与线程池混用

启用虚拟线程后，任务调度（@Scheduled）默认仍使用平台线程池，如需虚拟线程执行器，可自定义：

@Bean
TaskExecutor virtualThreadExecutor() {
    return new TaskExecutorAdapter(Executors.newVirtualThreadPerTaskExecutor());
}

并显式指定给 @Async。但需要注意，synchronized 块和 JNI 调用会导致虚拟线程被“钉住”，实际并发能力下降，应尽量使用 ReentrantLock。

3.4 可观测性成本

开启全量 tracing 会带来性能开销，生产环境建议采样概率设置为 0.1 或动态采样。此外，跟踪后端（如 Zipkin）的存储和查询性能也会成为瓶颈，需要合理规划保留策略。

四、总结

Spring Boot 3.x 并不仅仅是版本号的提升，它代表着 Java 生态向云原生、轻量化迈出的坚实一步。通过 AOT 编译和原生镜像，Java 应用也能拥有媲美 Go 的启动速度；虚拟线程让高并发编程回归简单的同步模型；内置可观测性则让微服务治理变得透明。当然，升级过程需要仔细处理 Jakarta 迁移和原生编译的兼容性，但带来的回报无疑是巨大的。

建议有计划升级的项目尽早搭建验证环境，充分利用这些新特性优化现有架构。相信随着生态的进一步完善，Spring Boot 3.x 将成为未来多年的主流选择。