虚拟线程

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 进入弃用倒计时，建议迁移到：

1. RestClient（同步，推荐简单场景）
2. 声明式 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");
    }
}

四种版本传递方式

1. 路径映射：/api/v1/user、/api/v2/user
2. 查询参数：/api/user?version=1
3. 请求头：Accept-Version: 1
4. 媒体类型头：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)

贡献者: AkaChou

上一页Spring Boot 4 MyBatis-Flex 实战

下一页linux学习笔记 一