Spring Boot 4.0 / Spring Framework 7.0 — 新特性与现代化升级背景 Spring

背景

Spring Boot 4.0 基于 Spring Framework 7.0。
本次升级面向现代 Java、云原生部署与高性能系统，底层依赖与生态栈均有重大改变。

核心新特性

1. Spring Framework 7.0 基础升级 & 现代运行时要求

Spring Boot 4.0 要求最低 Java 17，推荐使用 Java 21 或更高，以便利用最新 JVM 功能。
在 Kotlin 项目中，支持 Kotlin 2.2+，使 Kotlin + Spring 的组合更加顺畅。
底层切换到最新企业 Java 标准：采用 Jakarta EE 规范，弃用旧的 javax.* 命名空间。

2. 深度支持 GraalVM 原生镜像 (Native Image)

Spring Boot 4.0 将 GraalVM 原生镜像支持提升为生产级别，通过 Ahead-Of-Time (AOT) 编译，实现应用编译为原生可执行文件，从而大幅缩短启动时间、减少内存占用，非常适合云原生 / serverless / 容器化部署场景。

通常你可以通过 Maven/Gradle + AOT / native 配置将 Spring 应用构建为原生镜像。

3. 虚拟线程 (Virtual Threads) 支持 — 面向高并发

Spring Boot 4.0 / Spring Framework 7 对现代 JVM 并发特性（如虚拟线程）具有良好兼容性 / 支持，使得处理高并发、阻塞型 I/O、同步逻辑时更加轻量、高效。这意味着，如果你的服务以阻塞 I/O 为主，在高并发场景下可借助虚拟线程显著提升性能和资源利用效率。

4. 原生 API 版本控制 (API Versioning) 支持

Spring Framework 7 / Boot 4.0 引入原生 API 版本控制机制。你可以通过映射注解中的 version 属性定义接口版本 — 支持 path / header / query-param / media-type 等多种策略。适用于 Spring MVC 和 Spring WebFlux。

这样你可以优雅地管理不同版本 API，兼容老客户端，又能为新客户端提供新接口。

示例：

@RestController
@RequestMapping("/api/user")
public class UserController {

    @GetMapping(value = "/profile", version = "1")
    public UserV1 getUserProfileV1(...) {
        // 旧版本逻辑
    }

    @GetMapping(value = "/profile", version = "2")
    public UserV2 getUserProfileV2(...) {
        // 新版本逻辑
    }
}

5. 声明式 HTTP 客户端 (Declarative HTTP Clients) — 接口即客户端

Spring Boot 4.0 / Spring Framework 7 支持通过普通 Java 接口 + 注解定义 HTTP 客户端 (HTTP Service Clients / HTTP Interface Clients)，简化远程调用。开发者不必手写 HTTP 请求／解析／错误处理 —— Spring 会自动生成实现。

示例：

@HttpServiceClient("todoClient")
public interface TodoClient {

    @GetExchange("/todos/{id}")
    Todo getTodoById(@PathVariable long id);

    @PostExchange("/todos")
    Todo createTodo(@RequestBody TodoCreateRequest request);
}

然后，在配置类中注册：

@Configuration
@ImportHttpServices(group = "external", types = { TodoClient.class })
public class HttpClientsConfig {
}

之后你可以像调用本地方法一样调用远程服务，轻松调用远程 HTTP 接口。

优势包括：

✅ 零样板代码 (zero boilerplate)
✅ 类型安全 & 接口驱动
✅ 与 Spring 完全集成 (可结合 RestClient 或 WebClient)
✅ 支持组 (group) 级别配置

6. 支持 Jackson 3.x — JSON 处理库升级

在 Spring Boot 4.0 / Spring Framework 7 中，默认 JSON 序列化 / 反序列化库升级为 Jackson 3.x。Spring 官方推荐迁移到 Jackson 3，并将其作为默认 JSON 实现。

相比 Jackson 2.x，Jackson 3 在性能、非阻塞解析 (non-blocking parsing)、JSON 树模型 (JsonNode API) 的 null-safety 等方面都有改进。升级时注意兼容性。

7. Null-安全性改进 — 使用 JSpecify 注解

Spring Framework 7 / Boot 4.0 将 JSpecify 注解 (@Nullable / @NonNull 等) 作为标准 null-safety 机制。通过这些注解，IDE / 静态分析工具可以在开发 / 编译阶段检查潜在的空指针问题 (NPE)。

对于使用 Kotlin 的项目，JSpecify 注解也能很好映射到 Kotlin 的 nullability 系统。

示例：

import org.jspecify.annotations.NonNull;
import org.jspecify.annotations.Nullable;

public class Person {

    private String name;

    public void setName(@NonNull String name) {
        this.name = name;
    }

    @Nullable
    public String getName() {
        return this.name;
    }
}

使用上述标注后，IDE / 编译器能够提示你潜在的 null 问题，提升代码健壮性。

8. 完全迁移到 Jakarta EE 命名空间 / 新规范

Spring Boot 4.0 / Spring Framework 7 完全对齐 Jakarta EE 规范，包括 Servlet 6.x / Jakarta EE 相关规范。旧的 javax.* 命名空间不再推荐 / 支持。

这意味着，升级时可能需要修改旧项目中所有 javax.* 的导入，同时确保第三方库也已迁移到 Jakarta 兼容版本。

示例项目结构 + 快速入门 (Minimal 示例)

// build.gradle (关键部分)
plugins {
    id 'java'
    id 'org.springframework.boot' version '4.0.0'
}

java {
    sourceCompatibility = JavaVersion.VERSION_21
    targetCompatibility = JavaVersion.VERSION_21
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    // 使用 Jackson 3.x（Spring Boot 4 默认）
    // 其他依赖...
}

// 示例 Controller + API 版本控制 + null-safety
import org.jspecify.annotations.NonNull;
import org.jspecify.annotations.Nullable;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/api/user")
public class UserController {

    @GetMapping(value = "/profile", version = "1")
    public UserV1 getUserProfileV1(...) {
        // 旧版本逻辑
    }

    @GetMapping(value = "/profile", version = "2")
    public UserV2 getUserProfileV2(...) {
        // 新版本逻辑
    }
}

// 示例 HTTP 客户端声明式接口
@HttpServiceClient("todoClient")
public interface TodoClient {

    @GetExchange("/todos/{id}")
    Todo getTodoById(@PathVariable long id);
}

然后，你可以在服务中注入 TodoClient，像调用本地服务一样调用远程 HTTP 接口，非常简洁。

升级 / 注意事项

由于底层切换到 Jakarta EE、Jakarta Servlet 6.x 等标准，所有旧项目 (使用 javax.*) 需要修改包路径并升级兼容的容器（例如 Tomcat 11、Jetty 12+ 等）。
如果使用第三方库，请确认它们是否兼容 Jackson 3.x、Jakarta EE 规范、Spring Framework 7.0 / Spring Boot 4.0。
使用 GraalVM 原生镜像 / AOT 编译时，可能需要额外配置（例如反射元数据、资源加载规则等）。
虚拟线程 + 高并发 + 阻塞 I/O 场景下，请注意线程安全、资源访问、兼容性测试。

总结

Spring Boot 4.0 + Spring Framework 7.0 是一次面向 现代 Java / 云原生 / 高并发 / 高效 JSON / null-safety / 多版本 API / 原生部署 的全面升级。相比过去，这不仅仅是新功能堆叠，更是底层架构的现代化改造 — 如果你准备启动新项目，使用这一版本将能获得更好的性能与长期支持；如果你从旧项目迁移过来，也值得认真规划与测试。

欢迎你根据项目特点，选择性地使用这些新特性 — 也希望你在实践中分享使用体验与遇到的问题！