IntelliJ IDEA 2025.3 已正式發(fā)布，Spring 7 開箱即用。

REST API 版本控制

Spring 7 終于引入了內(nèi)置的一流版本機(jī)制?，F(xiàn)在你可以在映射注解中直接定義版本：

@GetMapping(path = "/quote", version = "1.0+")

ResponseEntity 
              
 getQuote() { 
       

        Quote result = quoteService.getRandomQuote();

return ResponseEntity.ok(result);

    }

IntelliJ IDEA 會(huì)自動(dòng)檢測(cè)版本控制。IDE 會(huì)檢查你的應(yīng)用是否配置了版本控制，識(shí)別你使用的是屬性還是 ApiVersionConfigurer 類，如果出現(xiàn)問(wèn)題還會(huì)發(fā)出警告。如果你忘記啟用版本控制，IDE 不僅會(huì)指出問(wèn)題所在，還會(huì)告訴你如何修復(fù)。

默認(rèn)情況下，IntelliJ IDEA 建議使用基于屬性的配置，通過(guò)頭部屬性啟用版本控制。這是一個(gè)安全的起點(diǎn)，如果需要進(jìn)行更復(fù)雜的操作，可以稍后進(jìn)行調(diào)整。

spring.mvc.apiversion.use.header=Api-Version

可以在 @GetMapping 注解中的版本號(hào)上按住 Ctrl 鍵點(diǎn)擊，直接跳轉(zhuǎn)至配置代碼。IDE 還會(huì)檢查你的版本值是否遵循標(biāo)準(zhǔn)的 SemVer 規(guī)則。

如果你使用的是自定義版本解析器，IntelliJ IDEA 不會(huì)進(jìn)行干擾。

Testing versioned APIs

在測(cè)試方面，你可以采用直接的方式，保持簡(jiǎn)單。

mockMvc.perform(get("/api/quote")

                        .accept(MediaType.APPLICATION_JSON)

                        .header("API-Version", "1.0")

                )

另一方面，Spring 7 允許你為測(cè)試配置 API 版本控制，并提供了一個(gè)新的 API ——apiVersion 方法：

IntelliJ IDEA 了解此 API，并會(huì)幫助你配置測(cè)試的版本控制。對(duì)于 header-based 的版本控制，代碼如下所示：

@TestConfiguration

staticclassQuoteControllerTestConfigimplementsMockMvcBuilderCustomizer{

@Override

publicvoidcustomize(ConfigurableMockMvcBuilder 
          builder){

            builder.apiVersionInserter(ApiVersionInserter.useHeader("Api-Version"));

        }

    }

此配置允許你在單個(gè)類中定義版本控制方法，從而大大簡(jiǎn)化測(cè)試維護(hù)。

HTTP Interface Clients

目前，要支持 HTTP Interface client 的版本控制，仍然需要手動(dòng)編寫配置。IntelliJ IDEA 2025.3 將 HTTP 接口識(shí)別為 bean —— 不再出現(xiàn)“紅色波浪線”或“無(wú)法解析 bean”的警告。無(wú)論在何處使用這些客戶端，都將獲得完整的自動(dòng)補(bǔ)全、導(dǎo)航和注入支持。

spring.http.serviceclient.default.apiversion.default-version=1.0.0


spring.http.serviceclient.default.apiversion.insert.header=API-Version

還可以查看每個(gè)客戶端的引用位置 —— 直接通過(guò)側(cè)邊欄圖標(biāo)或“Structure”工具窗口即可查看。展望未來(lái)，項(xiàng)目團(tuán)隊(duì)還在開發(fā)能夠檢測(cè)未注冊(cè)客戶端或錯(cuò)誤導(dǎo)入的檢查功能，甚至可以幫助開發(fā)者根據(jù) OpenAPI 規(guī)范生成客戶端。簡(jiǎn)而言之，就是讓開發(fā)者減少編寫 HTTP 客戶端的時(shí)間，從而將更多精力投入到改進(jìn)他們調(diào)用的 API 上。

Dynamic Bean Registration

新特性：BeanRegistrar 接口。有時(shí)需要?jiǎng)討B(tài)注冊(cè) Bean，而@Conditional 注解無(wú)法滿足需求。Spring 7 在能讓你以更優(yōu)雅的方式實(shí)現(xiàn)：

publicclassQuoteProviderRegistrarimplementsBeanRegistrar{

@Override

publicvoidregister(BeanRegistry registry, Environment env){

        registry.registerBean("quoteProviderDb", QuoteProviderDb.class);

        registry.registerBean("quoteProviderFallback", QuoteProviderFallback.class);

    }

}

如果你的 bean 構(gòu)造邏輯變得復(fù)雜或依賴于多個(gè)因素，那么 programmatic bean registration 就是一種巧妙的處理方法。IntelliJ IDEA 可以動(dòng)態(tài)識(shí)別這些 bean，因此你將不再看到那些煩人的“未解析的注入”警告。你可以直接從注入點(diǎn)導(dǎo)航到注冊(cè)。

IDE 無(wú)法預(yù)料到動(dòng)態(tài)注冊(cè)的所有極端情況 —— 這正是 Spring Debugger 發(fā)揮作用之處。在調(diào)試復(fù)雜的配置時(shí)，它會(huì)準(zhǔn)確地顯示運(yùn)行時(shí)注入的內(nèi)容。

更多詳情查看：

https://blog.jetbrains.com/idea/2025/11/intellij-idea-2025-3-spring-7/