或許你已經注意到了：當你最近新建一個 Spring Boot 項目時，在版本列表中已經可以看到 Spring Boot 4.0.0 的身影。而這次的升級，背后依托的是全新的 Spring Framework 7.0.0。

這次版本變更可不只是“修修補補”，而是一系列值得開發者認真關注的重大演進。我們接下來一項項分析它帶來了哪些影響深遠的升級。

接口版本控制更加簡潔優雅

Spring Boot 4 引入了對 API 接口進行版本管理的新方式。你可以在 @RequestMapping 里直接添加 version 參數，從而實現接口多版本共存。

例如：

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


    @RequestMapping(value = "/user", version = "1")
    public String getUserV1() {
        return "Version 1";
    }


    @RequestMapping(value = "/user", version = "2")
    public String getUserV2() {
        return "Version 2";
    }
}

通過這種方式，同一個 URL 可以根據版本號來返回不同的業務邏輯，實現真正意義上的“版本分流”。

Bean 注入機制變得更靈活

以往 Spring 注冊 Bean 時，通常依賴注解或手動配置。現在，可以通過實現 BeanRegistrar 接口，自定義 Bean 注冊策略，適用于根據環境動態注入不同的 Bean。

@Configuration
@Import(MyBeansRegistrar.class)
public class MyConfiguration {
}


class MyBeansRegistrar implements BeanRegistrar {
    @Override
    public void register(BeanRegistry registry, Environment env) {
        registry.registerBean("user", User.class);


        if (env.matchesProfiles("dev")) {
            registry.registerBean(Order.class, spec -> spec
                    .supplier(context -> new Order("order_001")));
        }
    }
}

這意味著你可以把 Bean 注冊邏輯寫得更清晰、更動態、更優雅。

空值安全支持提升：擁抱 JSpecify

為了更好地支持空值安全，Spring Boot 4 使用了 @Nullable 和 @NonNull 注解（來自 JSpecify 項目）。這讓你在編寫代碼時 IDE（如 IntelliJ IDEA 2024）就能在編譯期提供空值風險提示。

public class Person {
    private String name;


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


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

這樣就能有效防止 NullPointerException 的出現，尤其適合注重代碼魯棒性的項目。

HTTP 客戶端代理配置更簡單

通過 @ImportHttpServices 注解，可以一行配置完成多個 HTTP 客戶端的代理注冊。

@Configuration(proxyBeanMethods = false)
@ImportHttpServices(group = "weather", types = {FreeWeather.class, CommercialWeather.class})
@ImportHttpServices(group = "user", types = {UserServiceInternal.class, UserServiceOfficial.class})
static class HttpServicesConfiguration extends AbstractHttpServiceRegistrar {


    @Bean
    public RestClientHttpServiceGroupConfigurer groupConfigurer() {
        return groups -> groups.filterByName("weather", "user")
                .configureClient((group, builder) -> builder.defaultHeader("User-Agent", "My-Application"));
    }
}

這項功能尤其適合微服務間接口通信，可以讓你的 HTTP 服務定義更集中、更可控。

表達式語言增強：SPEL 語法變得更強大

Spring 表達式語言（SPEL）新增了對 null 安全和 Elvis 運算符（?:）的支持：

@Value("#{systemProperties['pop3.port'] ?: 25}")

這段代碼的含義是：如果系統屬性中不存在 pop3.port，則默認使用 25。無需再寫冗余的 if 判斷了。

原生鏡像支持更完善（GraalVM）

Spring Boot 4 借助 AOT（Ahead-of-Time）技術，提升了對 GraalVM 原生鏡像的支持。這意味著你可以將 Spring 應用直接編譯為二進制文件，在啟動速度和資源占用上都有質的飛躍。

部署路徑如 /opt/apps/my-spring-boot-native 將不再需要 JVM 啟動環境即可運行。

完全遷移至 Jackson 3.x

Spring Boot 4 完全拋棄了對 Jackson 2 的兼容，僅支持 Jackson 3.x。如果你的項目還依賴舊版 Jackson，那么是時候升級你的 JSON 處理邏輯了。

注意檢查 /src/main/resources/application.yml 或 /src/main/java/com/example/config/JacksonConfig.java 等配置文件。

Web 基礎庫升級：Servlet 6.1 + WebSocket 2.2

Spring Boot 4 將默認 Servlet API 升級到了 6.1，并支持 WebSocket 2.2。意味著你部署時需要使用 Tomcat 11+、Jetty 12.1+ 等兼容 Jakarta EE 11 的容器。

確保你的項目在 /usr/local/tomcat-11/bin 路徑下部署的是符合要求的版本，否則將無法正常運行。

HttpHeaders 操作 API 變得更現代

在處理請求頭時，可以用新的 firstValue 方法替代老舊的 getFirst。

@GetMapping("/headers")
public ResponseEntity<String> handleRequest(HttpHeaders headers) {
    String value = headers.firstValue("X-Custom-Header").orElse(null);


    headers.forEach((name, values) -> {
        System.out.println(name + ": " + values);
    });


    return ResponseEntity.ok("Processed");
}

API 更加面向 Optional，配合現代 Java 風格，更安全也更易維護。

已移除和棄用的功能一覽

• XML 配置的支持已被完全移除（如 /WEB-INF/spring/dispatcher-servlet.xml 等配置文件不再支持）。
• JUnit 4 與 Spring TestContext 集成已被棄用。
• Jackson 2.x 被移除。
• Spring JCL 日志模塊被正式停用。

環境要求提升：請準備好升級！

Spring Boot 4 對運行環境提出了更高要求：

• Jakarta EE 11
• Kotlin 2.x
• JSONassert 2.0
• GraalVM 23+

總結

Spring Boot 4 的變更不僅是版本號上的更新，更是開發模型與生態的一次大升級。從 Bean 管理、HTTP 代理、空值控制，到更好的表達式語言和更高效的原生支持，它真正改變了“我們如何寫 Spring Boot 應用”。

學習和適應這些新特性，能讓你寫出更現代、更安全、更高性能的代碼。

開發者的世界，唯一不變的就是變化。讓我們一起擁抱 Spring Boot 4，走在技術前沿！