Spring Boot 3.x 深度解析与迁移实践

第一步：环境准备

• 升级 Java 版本： 确保你的开发环境和服务器已安装 Java 17 或更高版本。这是硬性要求。
• 升级构建工具： 建议使用 Maven 3.6.3+ 或 Gradle 7.5+。
• 升级 Spring Boot 版本： 在 `pom.xml` 或 `build.gradle` 中，将 Spring Boot 版本更新到最新的 3.x 版本。建议先升级到 2.7.x 的最新版，解决所有废弃警告，再进行大版本升级。

第二步：处理最大的破坏性变更 - `javax` 到 `jakarta`

这是迁移过程中工作量最大的部分。所有原来使用 `javax.*` 包的 API 都需要改为 `jakarta.*`。

import javax.persistence.Entity;
import javax.servlet.http.HttpServletRequest;
import javax.validation.constraints.NotBlank;
                                

import jakarta.persistence.Entity;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.validation.constraints.NotBlank;
                                

第三步：适配第三方库和常见问题

许多第三方库也需要升级到支持 Jakarta EE 的版本。这是迁移过程中最容易出问题的地方。

@Configuration
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 使用新的分页插件, 并指定数据库类型
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

<!-- 移除 springfox 依赖 -->
<!--
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
</dependency>
-->

<!-- 添加 springdoc 依赖 -->
<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
    <version>2.5.0</version>
</dependency>

GraalVM 原生镜像 vs. 传统 JVM

AOT 编译在构建时就将代码直接编译成本地机器码，避免了 JVM 在运行时进行的即时编译（JIT）和类加载开销。这带来了巨大的性能优势，尤其是在启动速度和内存消耗上。

现代化的同步 HTTP 客户端：`RestClient`

`RestClient` 是 `RestTemplate` 的直接继承者，它借鉴了响应式 `WebClient` 的流式 API 设计，但保持了同步阻塞的特性。这使得编写清晰、流畅的 HTTP 调用代码变得非常简单。

@Service
public class UserService {
    private final RestClient restClient;

    public UserService(RestClient.Builder builder) {
        this.restClient = builder.baseUrl("https://api.github.com").build();
    }

    public String getGithubUser(String username) {
        return restClient.get()
                .uri("/users/{user}", username)
                .accept(MediaType.APPLICATION_JSON)
                .retrieve() // 发送请求并处理响应
                .body(String.class); // 将响应体转换为 String
    }
}

标准化的错误响应：RFC 7807 Problem Details

只需在配置中开启 `spring.mvc.problemdetails.enabled=true`，Spring Boot 就会在发生错误时，自动返回符合 RFC 7807 标准的 JSON 响应。这为构建健壮、可预测的 API 提供了极大的便利。

{
  "type": "urn:problem-type:not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "User 'testuser' not found",
  "instance": "/api/users/testuser"
}

统一的可观测性：Micrometer 与 OpenTelemetry

Spring Boot 3 将可观测性提升到新的高度。它内置了 Micrometer Tracing，统一了分布式追踪的 API。更重要的是，它将 OpenTelemetry 作为首选的追踪解决方案，使你的应用可以无缝接入 Prometheus、Jaeger、Zipkin 等主流监控生态系统。

只需添加 `spring-boot-starter-actuator` 和 `micrometer-tracing-bridge-otel` 依赖，即可自动开启分布式追踪。日志中会自动包含 `traceId` 和 `spanId`，便于链路追踪。