别盲目升级！Spring Boot 4 与 Spring Framework 7 新特性：开发者必须知道的变化

章为忠学架构

发布于 2025-11-04 13:36:00

3.3K1

Spring 生态又迎来重大更新！Spring Framework 7 和 Spring Boot 4 带来了许多令人期待的新特性，不仅能提升开发效率，还加强了对现代技术栈的支持。本文将带你全面了解这些新变化，并通过代码示例展示如何使用这些新特性。

一、最低版本要求的变化

首先，需要注意的是新版本对基础环境的要求有所提高：

Java 最低版本：Java 17（之前版本支持 Java 8+）
Jakarta EE 版本：从 Java EE 迁移到 Jakarta EE 11
构建工具：Maven 3.6.3+ 或 Gradle 8.5+

这意味着如果你还在使用 Java 8 或 11，甚至更低的版本，那么，在升级前需要先规划好 JDK 的升级路径。

二、Spring Framework 7 的核心新特性

1. 全面支持 Jakarta EE 11

Spring Framework 7 完成了从 javax.* 到 jakarta.* 包名的迁移，这是最显著的变化之一。

之前版本（Spring Framework 6）：

import javax.servlet.http.HttpServletRequest;
import javax.persistence.Entity;

Spring Framework 7：

import jakarta.servlet.http.HttpServletRequest;
import jakarta.persistence.Entity;

这一变化虽然简单，但影响范围广，在升级时需要特别注意相关依赖的更新。

2. 改进的 AOT 支持

AOT（Ahead-of-Time）编译支持得到进一步增强，能在构建时生成更多代码，减少运行时开销，特别有利于原生镜像（Native Image）的构建。

在 Spring Boot 项目中启用 AOT 非常简单，只需添加以下依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-aot</artifactId>
    <scope>provided</scope>
</dependency>

然后使用 Maven 命令构建：

mvn spring-boot:process-aot package

3. 新的核心注解

Spring 7 引入了一些新注解，使代码更简洁：

@Nullable 和 @NonNull：更明确地标记可为空和不可为空的元素
@ManagedBean：简化托管 bean 的定义

示例：

import org.springframework.lang.NonNull;
import org.springframework.lang.Nullable;
@Service
public class UserService {

    // 明确参数不可为空
    public User getUserById(@NonNull String id) {
        // ...
    }

    // 明确返回值可能为空
    @Nullable
    public User findUserByEmail(String email) {
        // ...
    }
}

三、Spring Boot 4 的重要更新

1. 优雅的API版本控制

Spring Boot 4.0在@RequestMapping注解中新增了version属性，实现了API版本控制的革命性简化：

RestController
@RequestMapping("/api")
public class VersionedController {

    @RequestMapping(value = "/user", version = "1")
    public String getUserV1() {
        // 版本1实现
        System.out.println("Version 1");
        return "Version 1";
    }

    @RequestMapping(value = "/user", version = "2")
    public String getUserV2() {
        // 版本2实现
        System.out.println("Version 2");
        return "Version 2";
    }
}

调用时，可以通过Version头部指定所需的API版本：

#调用V1 API
GET /api/user

Version: 1

#调用V2 API
GET /api/user

Version: 2

2. 自动配置的改进

Spring Boot 4 对自动配置进行了优化，引入了更智能的条件判断：

@Configuration
// 仅当特定类存在且满足条件时才生效
@ConditionalOnClass(name = "com.fasterxml.jackson.databind.ObjectMapper")
@ConditionalOnProperty(name = "app.json.enabled", havingValue = "true")
public class JsonConfiguration {
    // ...
}

3. 简化的 Web 控制器

Spring Boot 4 简化了 REST 控制器的编写方式，引入了 @RestControllerAdvice 的增强功能：

@RestController
@RequestMapping("/api/users")
public class UserController {
    private final UserService userService;

    // 构造函数注入无需 @Autowired 注解
    public UserController(UserService userService) {
        this.userService = userService;
    }

    @GetMapping("/{id}")
    // 直接返回响应体，自动处理异常
    public ResponseEntity<User> getUser(@PathVariable String id) {
        return userService.findById(id)
            .map(ResponseEntity::ok)
            .orElse(ResponseEntity.notFound().build());
    }

    // 新的请求参数处理方式
    @GetMapping
    public List<User> searchUsers(
            @RequestParam(required = false) String name,
            @RequestParam(defaultValue = "0") int page,
            @RequestParam(defaultValue = "20") int size) {
        return userService.search(name, PageRequest.of(page, size));
    }
}

4. 原生镜像支持增强

Spring Boot 4 对 GraalVM 原生镜像的支持更加成熟，现在可以轻松构建高性能的原生应用：

# 使用 Spring Boot 插件构建原生镜像
mvn spring-boot:build-image

构建的原生镜像启动速度比传统 JVM 应用快 10 倍以上，内存占用也大幅降低。

5. 支持 Jackson 3.x

Spring Boot 4.0 已经放弃了对Jackson 2.x的支持，全面升级为3.x。Jackson 3.0 在 Spring Boot 4.x 中的升级是一次重大变更，主要影响包括：

1. 包名从 com.fasterxml.jackson 变更为 tools.jackson;
2. 强制使用 Builder 模式创建 ObjectMapper ；
3. 异常处理从受检异常变为运行时异常；

之前版本：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.annotation.JsonProperty;

Spring Boot 4.x：

import tools.jackson.databind.ObjectMapper;
import tools.jackson.annotation.JsonProperty;

6. 改进的测试支持

Spring Boot 4 简化了测试代码的编写，特别是对 Web 测试的支持：

@SpringBootTest
@AutoConfigureMockMvc
class UserControllerTest {
    @Autowired
    private MockMvc mockMvc;

    @Test
    void shouldReturnUserWhenExists() throws Exception {
        mockMvc.perform(get("/api/users/1")
                .accept(MediaType.APPLICATION_JSON))
                .andExpect(status().isOk())
                .andExpect(jsonPath("$.id").value("1"))
                .andExpect(jsonPath("$.name").value("John Doe"));
    }
}