Spring Boot 4 其他核心变更

约 1635 字大约 5 分钟

Spring Boot 4虚拟线程GraalVM可观测性

次阅读

2026-04-09

⚠ 请注意，本文编写于 89 天前，最后最后修改于 74 天前，其中某些信息可能已经过时。

虚拟线程

Spring Boot 4 对 Java 21+ 虚拟线程（Virtual Threads）提供了一等公民支持。

启用方式

spring:
  threads:
    virtual:
      enabled: true

效果

启用后以下场景自动使用虚拟线程：

HTTP 请求处理（Tomcat/Jetty 的每个请求分配一个虚拟线程）
@Async 异步方法
数据访问阻塞操作
Spring WebClient 阻塞调用

监控

Actuator 新增 /actuator/virtual-threads 端点用于监控虚拟线程状态。

性能实测

IO 密集场景（大量数据库查询、HTTP 调用）吞吐量提升 5-7 倍，且无需修改任何业务代码。

与 Spring Boot 3.x 的差异

对比项	Spring Boot 3.x	Spring Boot 4.x
虚拟线程支持	实验性（需 Java 21+）	一等公民（推荐 Java 21+）
Actuator 监控	无专用端点	新增 `/actuator/virtual-threads`
自动调度范围	部分	全面覆盖请求、异步、数据访问

GraalVM 原生镜像

从实验特性升级为生产级支持。

变化

对比项	Spring Boot 3.x	Spring Boot 4.x
GraalVM 版本	22.x+	GraalVM 25+
支持级别	实验性	生产级
AOT 编译速度	基准	提升 30%
内存占用	基准	减少 80%
反射控制	需手动配置 JSON	新增 `@NativeHint` 注解

@NativeHint 注解

精确控制反射和资源加载，替代手写 reflect-config.json：

@NativeHint(
    types = @TypeHint(
        types = MyService.class,
        access = { AccessBits.DECLARED_CONSTRUCTORS, AccessBits.DECLARED_METHODS }
    ),
    resources = @ResourceHint(
        patterns = { "my-config.properties", "schema.sql" }
    )
)
@SpringBootApplication
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

可观测性（Observability）

Micrometer 2.0

Spring Boot 4 升级到 Micrometer 2.0，主要变化：

API 更简洁，减少了样板代码
更好的 OpenTelemetry 集成
Trace、Log、Metrics 三者无缝配合

OpenTelemetry Starter

新增专门的 OpenTelemetry starter：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-opentelemetry</artifactId>
</dependency>

SSL 证书过期监控

Actuator 增强了 SSL 证书过期监控能力，可提前预警证书即将过期：

management:
  server:
    ssl:
      # 证书即将过期的告警天数
      certificate-notifier:
        warning-threshold: 30d

声明式 HTTP 客户端

Spring Framework 7 引入了声明式 HTTP 客户端，可作为 Feign 的原生替代。

基本使用

// 声明接口
@HttpServiceClient("user-service")
public interface UserServiceClient {

    @GetExchange("/users/{id}")
    UserDTO getUserById(@PathVariable Long id);

    @PostExchange("/users")
    UserDTO createUser(@RequestBody UserCreateDTO dto);

    @GetExchange("/users")
    List<UserDTO> listUsers(@RequestParam String keyword);
}

优势

原生支持，无需引入外部依赖
原生支持响应式编程（Reactive）
原生支持虚拟线程
与 Spring Cloud 服务发现无缝集成

RestTemplate 弃用

RestTemplate 进入弃用倒计时，建议迁移到：

RestClient（同步，推荐简单场景）
声明式 HTTP 客户端（推荐复杂场景）

// RestClient 示例（Spring Boot 3.x 已引入，4.x 继续推荐）
@RestController
public class MyController {

    private final RestClient restClient;

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

    public User getUser(Long id) {
        return restClient.get()
            .uri("/users/{id}", id)
            .retrieve()
            .body(User.class);
    }
}

弹性能力内置

Spring Framework 7 内置了重试、限流等弹性注解，不再需要外部库（如 Spring Retry、Resilience4j）。

使用方式

@Configuration
@EnableResilientMethods  // 启用弹性方法支持
public class ResilientConfig {
}

@Service
public class MyService {

    @GetExchange("/data")
    @Retryable(maxAttempts = 3, delay = 100, multiplier = 2, maxDelay = 1000)
    @ConcurrencyLimit(3)  // 并发限制
    public String getData() {
        // 远程调用
    }
}

Spring Retry 的依赖管理在 Spring Boot 4 中已被移除，因为弹性能力已内置到 Spring Framework 7。

API 版本控制

Spring Framework 7 原生支持 API 版本控制。

基于注解的版本控制

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

    @GetMapping(version = "1")
    public UserV1 getUserV1() {
        return new UserV1("张三");
    }

    @GetMapping(version = "2")
    public UserV2 getUserV2() {
        return new UserV2("张三", "zhangsan@example.com");
    }
}

四种版本传递方式

路径映射：/api/v1/user、/api/v2/user
查询参数：/api/user?version=1
请求头：Accept-Version: 1
媒体类型头：Accept: application/vnd.company.v1+json

通过配置选择版本传递策略：

spring:
  mvc:
    versioning:
      default-version: 1
      type: header  # 可选：uri, header, media-type, param
      header: X-API-Version

JSpecify 空安全

Spring Boot 4 全面采用 JSpecify 注解替代之前混乱的空值注解生态。

影响

Spring API 中的 @Nullable 注解统一迁移到 JSpecify 规范
Kotlin 用户受益最大：Spring API 在 Kotlin 中会自动呈现为空安全类型，编译器能精确推断可空性
Java 用户可通过 JSpecify 注解获得更好的 IDE 空值提示

测试变更

`@SpringBootTest` 行为变更

这是 Spring Boot 4 测试领域最大的变化：

// Spring Boot 3.x：@SpringBootTest 自动提供 MockMvc 和 TestRestTemplate
@SpringBootTest
class MyTest {
    @Autowired
    MockMvc mockMvc;  // ✅ 自动注入

    @Autowired
    TestRestTemplate restTemplate;  // ✅ 自动注入
}

// Spring Boot 4.x：需要显式启用
@SpringBootTest
@AutoConfigureMockMvc  // 必须显式声明
@AutoConfigureTestRestTemplate  // 必须显式声明（如果需要）
class MyTest {
    @Autowired
    MockMvc mockMvc;  // ✅

    @Autowired
    TestRestTemplate restTemplate;  // ✅
}

新增 RestTestClient

推荐使用 RestTestClient 测试 REST 接口：

@SpringBootTest
@AutoConfigureRestTestClient
class UserApiTest {

    @Autowired
    RestTestClient restTestClient;

    @Test
    void getUser() {
        restTestClient.get().uri("/api/user/1")
            .exchange()
            .expectStatus().isOk()
            .expectBody(UserDTO.class)
            .isEqualTo(new UserDTO(1L, "张三"));
    }
}

MockBean 变更

// Spring Boot 3.x
@MockBean
private UserService userService;

// Spring Boot 4.x
@MockitoBean  // 新名称
private UserService userService;

@MockitoSpyBean  // 替代 @SpyBean
private UserService userService;

Test Starter

每个技术 starter 都有对应的 -test 版本，且已传递依赖 spring-boot-starter-test：

<!-- 不再需要显式声明 spring-boot-starter-test -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis-test</artifactId>
    <scope>test</scope>
</dependency>

重要移除项一览

移除项	替代方案	说明
Undertow	Tomcat / Jetty	不支持 Servlet 6.1
Pulsar Reactive	-	Spring Pulsar 移除了 reactor 支持
嵌入式 Uber Jar 启动脚本	-	不再支持 fully executable jar
Spock 集成	JUnit 5	Spock 不支持 Groovy 5
Spring Session Hazelcast/MongoDB	-	交给各自团队维护
`@MockBean` / `@SpyBean`	`@MockitoBean` / `@MockitoSpyBean`	-
`MockitoTestExecutionListener`	`MockitoExtension`	-
`HttpMessageConverters`	`ClientHttpMessageConvertersCustomizer` / `ServerHttpMessageConvertersCustomizer`	-
Spring Retry 依赖管理	内置 `@Retryable`	弹性能力已内置到 Spring Framework 7
Spring Batch 默认数据库存储	`spring-boot-starter-batch-jdbc`	需显式引入

其他行为变更

变更	说明
`RestTemplate` 进入弃用倒计时	建议迁移到 `RestClient` 或声明式 HTTP 客户端
DevTools Live Reload 默认禁用	需手动 `spring.devtools.livereload.enabled=true`
Liveness/Readiness 探针默认启用	可通过 `management.endpoint.health.probes.enabled` 关闭
`spring-boot-starter-web` 重命名	改为 `spring-boot-starter-webmvc`（旧名保留为 deprecated）
`spring-boot-starter-aop` 重命名	改为 `spring-boot-starter-aspectj`
包路径重组	`BootstrapRegistry` 移至 `org.springframework.boot.bootstrap` 等

Kotlin 支持增强

Kotlin 基线升级到 2.2
新增 spring-boot-starter-kotlinx-serialization-json
协程自动上下文传播
BeanRegistrarDsl 支持 DSL 风格注册 Bean

// Kotlin DSL Bean 注册（Spring Boot 4 新特性）
beans {
    bean<MyService>()
    bean<AnotherService>()
    bean {
        MyController(ref(), ref())
    }
}

相关文章：
Spring Boot 4 概览与迁移指南
Jackson 配置与迁移
Redis 集成使用
MyBatis-Flex 实战

版权所有

版权归属：AkaChou

许可证：署名 4.0 国际 (CC-BY-4.0)

Spring Cloud

SpringBoot4合集

linux基础