Spring Boot 3.0 現(xiàn)已正式發(fā)布，它包含了 12 個月以來 151 個開發(fā)者的 5700 多次代碼提交。這是自 4.5 年前發(fā)布 2.0 以來，Spring Boot 的第一次重大修訂。

它也是第一個支持 Spring Framework 6.0 和 GraalVM 的 Spring Boot GA 版本，同時也是第一個基于Java 17的Spring Boot版本，以Jakarta EE 9為基準(zhǔn)并支持Jakarta EE 10。同時借助于GraalVM支持了AOT和Native Image。

3.0升級指南

如果你想嘗試Spring Boot 3.0，不妨參考胖哥精心準(zhǔn)備的升級指南。

升級JDK

首先要升級你的JDK到JDK17，如果你要使用Native Image特性，要使用GraalVM 22.3以上和 Native Build Tools Plugin 0.9.17 或更高的版本。

平滑升級

這里不建議直接從低于Spring Boot 2.7的版本直接升級到Spring Boot 3.0。不然新特性和API變更太多，就需要你修改大量的配置，升級路徑會過于陡峭。建議通過小版本號分階段升級到2.4、2.6、2.7，最后再到3.0。

依賴評估

Spring Boot3.0下依賴組件的版本要求也不盡相同，比如Spring Boot Kafka Starter可能對Kafka有什么要求，這要求你進(jìn)行充分評估。Spring Cloud體系應(yīng)該在對應(yīng)的Spring Boot 3.0體系發(fā)布后進(jìn)行升級。

升級到Spring Boot 3

一旦上面的工作準(zhǔn)備完畢，你就可以開始嘗試升級到Spring Boot 3.0了。

配置屬性兼容

在Spring Boot 3.0中，一些配置屬性被重新命名/刪除了，開發(fā)人員需要相應(yīng)地更新他們的application.properties?或者application.yml?。為了幫助你做到這一點，Spring Boot 3.0提供了一個spring-boot-properties-migrator?模塊。一旦作為依賴關(guān)系添加到你的項目中，它不僅會在啟動時分析你的應(yīng)用程序的環(huán)境并打印診斷結(jié)果，而且還會在運行時為你臨時遷移屬性。把下面這個加入pom.xml以幫助你升級兼容配置屬性：

<dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-properties-migrator</artifactId>
 <scope>runtime</scope>
</dependency>

完成遷移之后，務(wù)必要移除spring-boot-properties-migrator依賴。

Jakarta EE

由于Java EE已經(jīng)變更為Jakarta EE，包名以 javax?開頭的需要相應(yīng)地變更為jakarta。這里建議通過Intellij IDEA 2021.2提供的內(nèi)置功能批量處理即可：

當(dāng)然你也可以手動去變更包名。

升級的關(guān)鍵變更

Spring Boot 3.0有一些關(guān)鍵改變，這些改變將與大多數(shù)應(yīng)用程序有關(guān)。所以開發(fā)者要仔細(xì)閱讀這些變更。

圖片Banner不再支持

現(xiàn)在Spring Boot 3.0自定義Banner只支持文本類型（banner.txt），不再支持圖片類型。

日志日期格式變更

Logback和Log4j2的日志消息的日期和時間部分的默認(rèn)格式已經(jīng)改變，以符合ISO-8601標(biāo)準(zhǔn)。新的默認(rèn)格式y(tǒng)yyy-MM-dd'T'HH:mm:ss.SSSXXX?使用T?來分隔日期和時間，而不是空格字符，并在最后添加時區(qū)偏移。LOG_DATEFORMAT_PATTERN?環(huán)境變量或logging.pattern.dateformat?屬性可以用來恢復(fù)以前的默認(rèn)值yyyy-MM-dd HH:mm:ss.SSS。

ConstructingBinding注解

配置屬性類注解@ConfigurationProperties?默認(rèn)情況下不再需要使用@ConstructorBinding來標(biāo)記構(gòu)造，你應(yīng)該從配置類上移除它，除非該配置類多個構(gòu)造函數(shù)來明確配置屬性綁定。

YamlJsonParser被移除

因為SnakeYAML的JSON?解析與其他解析器的實現(xiàn)不一致。如果你直接使用YamlJsonParser?，請遷移到其他JsonParser實現(xiàn)中。

自動配置文件變更

Spring Boot 2.7引入了一個新的文件：

META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

用于注冊自動配置，同時保持與 spring.factories? 中注冊的向后兼容。Spring Boot 3.0發(fā)布后，spring.factories?已經(jīng)被移除，只能通過imports文件來注冊自動配置。

Web應(yīng)用變更

路徑匹配

現(xiàn)在Spring MVC和Spring Webflux 的路徑匹配規(guī)則已經(jīng)做了調(diào)整，默認(rèn)情況下尾部斜杠/的匹配機(jī)制將和以前不同：

• 3.0以前/foo/bar?等同于/foo/bar/
• 3.0以后/foo/bar?不同于/foo/bar/

棄用配置 server.max-http-header-size

server.max-http-header-size?已經(jīng)被棄用，現(xiàn)在用server.max-http-request-header-size?替代 ，并且現(xiàn)在該屬性只能來配置請求頭的大小，不再限制某些Web容器的響應(yīng)頭大小，如果需要限制響應(yīng)頭大小請通過自定義WebServerFactoryCustomizer來實現(xiàn)。

優(yōu)雅停機(jī)階段變更

優(yōu)雅停機(jī)由SmartLifecycle?實現(xiàn)，在SmartLifecycle.DEFAULT_PHASE - 2048?階段開始，Web服務(wù)器在SmartLifecycle.DEFAULT_PHASE - 1024階段停止。任何參與優(yōu)雅關(guān)機(jī)的SmartLifecycle實現(xiàn)都應(yīng)該被相應(yīng)地更新。

Jetty

由于Jetty目前還不支持Servlet 6.0，使用Jetty的開發(fā)者需要通過降低Jakarta Servlet的版本為5.0。

數(shù)據(jù)訪問相關(guān)的變更

spring.data?前綴已被保留給Spring Data項目，如果你使用了Spring Data項目的子項目，application.yaml?中相關(guān)的配置屬性就需要響應(yīng)的變更。例如 spring.redis?現(xiàn)在需要修改為spring.data.redis。

數(shù)據(jù)訪問相關(guān)的組件現(xiàn)在都使用了比較新的版本：

• Flyway更新到 9.0
• Hibernate 更新到 6.1
• R2DBC 更新到 1.0

Mongodb

另外 Flapdoodle 嵌入式 MongoDB 的自動配置被移除，開發(fā)者有需要的話需要自行引入。

Elasticsearch

Elasticsearch的Rest客戶端采用了新的API實現(xiàn)，舊的自動配置和Spring Data Elasticsearch中舊的客戶端API已經(jīng)被移除。

Spring Security

相關(guān)的變更，胖哥稍后會整理并獨立分享。

其它變更

可觀測性、度量跟蹤、Maven、Gradle也都有不同程度的變更，有需要可以查看官方的Spring-Boot-3.0-Migration-Guide 。

記得收藏這一篇，后續(xù)胖哥會深入Spring 6.0和Spring Boot 3.0的細(xì)節(jié)部分。