Spring Cloud Tencent發(fā)布最新匹配版本！

Spring Framework 6.0 已于11月份上旬正式發(fā)布 GA 版本。Spring Boot 3.0 也于11月25日正式發(fā)布 GA 版本。那么 Spring Cloud 2022 它還遠嗎？

前言

Java 8 目前是國內(nèi)主流生產(chǎn)環(huán)境 Java 版本之一。雖然近幾年陸續(xù)發(fā)布了 Java 11、Java 17 官方 LTS 版本，但是 “你發(fā)任你發(fā)，我用Java8” 的聲音反應(yīng)了大部分開發(fā)者的心聲。不過 Java 17 版本在性能上做了大量的優(yōu)化特別是 ZGC 的發(fā)布，促進了國內(nèi)不少企業(yè)升級到 Java 17。

Spring 在 Java 語言的作用不言而喻，Spring Framework 5.0 發(fā)布已至今五年，是時候需要一個大的版本來革新技術(shù)棧了。借著 Java 17 的東風(fēng)我們認為

“Java 17 + Spring Framework 6.0 + Spring Boot 3.0 + Spring Cloud 2022”

組合一定會在不久的將來被大家所接受，成為主流技術(shù)棧。當(dāng)然任何新技術(shù)大規(guī)模被認可、落地都會有一定的滯后性，技術(shù)的發(fā)展 “穩(wěn)”字當(dāng)頭。

Spring Cloud Tencent 是基于騰訊開源的一站式微服務(wù)平臺北極星（集服務(wù)注冊發(fā)現(xiàn)、配置中心、服務(wù)限流熔斷、服務(wù)路由于一身）實現(xiàn)的 Spring Cloud 微服務(wù)解決方案套件。真正做到 “All In One”、 開箱即用，極大的降低企業(yè)的微服務(wù)實踐門檻。

無論北極星還是 Spring Cloud Tencent 當(dāng)前都在積極的修復(fù) Bug、完善用戶體驗、迭代新功能。所以 Spring Cloud Tencent 也第一時間適配了 Spring Cloud 2022。此篇文章詳細講述了 Spring Cloud Tencent 從 2021 版本升級到 2022 版本的改動點。為嘗鮮 2022 版本的廣大開發(fā)者提供一些參考。

一、升級過程

1.1 升級安裝 JDK 17

Oracle 官網(wǎng)下載 JDK 17 并安裝。安裝之后，本地修改 JAVA_HOME 環(huán)境變量，如下所示：

#echo$JAVA_HOME
/Library/Java/JavaVirtualMachines/jdk-17.0.5.jdk/Contents/Home
#java-version
javaversion"17.0.5"2022-10-18LTS
Java(TM)SERuntimeEnvironment(build17.0.5+9-LTS-191)
JavaHotSpot(TM)64-BitServerVM(build17.0.5+9-LTS-191,mixedmode,sharing)

安裝好 JDK 17 之后，同時需要在 Idea 里設(shè)置項目的編譯和運行環(huán)境為 SDK 17。

1.2 升級依賴版本

Spring Cloud Tencent 項目引用的 Parent Pom 是 spring-cloud-build，所以需要升級到最新版本。

<parent>
<groupId>org.springframework.cloudgroupId>
<artifactId>spring-cloud-buildartifactId>
<version>4.0.0-RC2version>
<relativePath/>
parent>

可以看到 Spring-cloud-build 4.0.0-RC2 版本里定義的 Java 和 Spring Boot 版本已是最新的 Java 17 和 Spring Boot 3.0

<properties>
<java.version>17java.version>
<spring-boot.version>3.0.0-RC2spring-boot.version>
properties>

普通項目一般不需要繼承 spring-cloud-build ，而是通過 bom 的方式引入 Spring 全家桶。如果你的項目里定義了 Java、Spring Framework、Spring Boot、Spring Cloud 版本則需要同時升級。如下所示：

<properties>
<java.version>17java.version>
<spring.framework.version>6.0.1spring.framework.version>
<spring-boot.version>3.0.0spring-boot.version>
<spring.cloud.version>2022.0.0-RC2spring.cloud.version>
properties>
<dependencyManagement>
<dependencies>

<dependency>
<groupId>org.springframeworkgroupId>
<artifactId>spring-framework-bomartifactId>
<version>${spring.framework.version}version>
<type>pomtype>
<scope>importscope>
dependency>


<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-dependenciesartifactId>
<version>${spring.boot.version}version>
<type>pomtype>
<scope>importscope>
dependency>


<dependency>
<groupId>org.springframework.cloudgroupId>
<artifactId>spring-cloud-dependenciesartifactId>
<version>${spring.cloud.version}version>
<type>pomtype>
<scope>importscope>
dependency>
dependencies>
dependencyManagement>

注意：Spring 非 GA 版本會先發(fā)布到 Spring 自己的 Maven 倉庫，而不會發(fā)布到中央倉庫。所以如果拉不到包，則需要在項目根 Pom 或者本地 ~/.m2/settings.xml 里配置 Spring Maven 倉庫。

<repositories>
<repository>
<id>nexus-snapshotsid>
<url>https://oss.sonatype.org/content/repositories/snapshots/url>
<releases>
<enabled>falseenabled>
releases>
<snapshots>
<enabled>trueenabled>
snapshots>
repository>
<repository>
<id>spring-snapshotsid>
<name>SpringSnapshotsname>
<url>https://repo.spring.io/snapshoturl>
<snapshots>
<enabled>trueenabled>
snapshots>
<releases>
<enabled>falseenabled>
releases>
repository>
<repository>
<id>spring-milestonesid>
<name>SpringMilestonesname>
<url>https://repo.spring.io/milestoneurl>
<snapshots>
<enabled>falseenabled>
snapshots>
repository>
repositories>

在升級過程中，大概率會出現(xiàn)包沖突的情況，例如 SCT 在升級過程中發(fā)現(xiàn)日志依賴有問題導(dǎo)致 example 啟動失敗。最后排查到原因：SCT 自己定義了 logback版本為 1.2.11，但是升級 Spring Boot 3.0 里傳遞依賴的版本為 1.4.5，所以導(dǎo)致版本沖突。最后解決方案就是把 SCT 定義的版本去掉，只用傳遞依賴的版本。

Tips：解決版本沖突大概率會占用比較多的時間，升級過程需要有耐心

1.3 修改不兼容代碼

javax 包替換為 jakarta 包

這是Java17 最大變更點之一，代碼所有 import javax 都要替換為 jakarta。編譯不通過的地方直接通過 Idea 自動導(dǎo)入的方式變更即可。

spring-web 6.0 不兼容升級

SCT 在升級過程中發(fā)現(xiàn) spring-web 包下有些 API 不兼容，例如 ClientHttpResponse.getStatusCode() 老版本返回 HttpStatus，新版本返回的是 HttpStatusCode，改動量很小。

AutoConfiguration 自動裝配方式變更

在 Spring Boot 3.0 以前的版本，通過在 META-INF/spring.factories 文件中定義需要自動裝配類，Spring Boot 在啟動過程中就會執(zhí)行裝配 Bean，如下所示：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.tencent.cloud.plugin.pushgateway.PolarisStatPushGatewayAutoConfiguration

但是在 Spring Boot 3.0 中，則是通過在

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

文件定義需要自動裝配的類。所以遷移過程就是把org.springframework.boot.autoconfigure.EnableAutoConfiguration 下配置的類都放到新的文件中。

這里需要注意的是原來在 spring.factories 可以定義多種類型的自動裝配例如：

1. org.springframework.boot.autoconfigure.EnableAutoConfiguration
2. org.springframework.cloud.bootstrap.BootstrapConfiguration
3. org.springframework.context.ApplicationListener
4. ... ...

只需要把 org.springframework.boot.autoconfigure.EnableAutoConfiguration 部分遷移到 org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件，其它部分還是放在 spring.factories 中無需遷移。

至此 SCT 2022 升級適配工作即已完成，可以看出升級工作量不大。

1.4 升級總結(jié)

SCT 屬于比較底層的基礎(chǔ)組件依賴的第三方庫少，所以整體適配工作量少。如果您的應(yīng)用是上層業(yè)務(wù)應(yīng)用依賴了大量的組件，例如：spring-security、spring-stream等。那升級的成本也會高很多。

下面是 github 網(wǎng)友 @herodotus-cloud 總結(jié)的升級關(guān)鍵點：

1. 更換 JDK 17 后，少部分第三方依賴包版本選擇和控制問題
2. 新依賴包過時代碼替換。大多數(shù)沒問題，就怕遇到像 spring security 6 用法的變化
3. starter 自動配置注冊格式不同導(dǎo)致的，大多數(shù)第三方依賴都倒在這里
4. 最怕的就是核心機制的變化，比如說反射。好像一些反射在 JDK 17 會有問題
5. 最大的問題就是基礎(chǔ)設(shè)置組件升級不同步或者緩慢問題，比如依賴的某個 SDK 沒有升級 SDK 17，如果傳遞依賴了就會導(dǎo)致編譯問題。
6. 如果還要考慮向下的兼容性，怕就難了

Spring 官方建議先升級到 Spring Boot 2.7 小版本，然后再升級到 Spring Boot 3.0 版本。通過小步升級的方式，可以更加的平滑。

二、嘗鮮使用 Spring Cloud Tencent 2022.0 版本

Spring Cloud Tencent 1.8.1-2022.0.0 版本已發(fā)布。通過引入 SCT BOM 的方式即可引入，如下所示：

<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.tencent.cloudgroupId>
<artifactId>spring-cloud-tencent-dependenciesartifactId>
<version>1.8.1-2022.0.0-RC2version>
<type>pomtype>
<scope>importscope>
dependency>
dependencies>
dependencyManagement>

在此解釋一下 SCT 的版本號規(guī)則，版本號分為兩段：

{對應(yīng)的 Spring Cloud 版本}

SCT 版本號在各個 Spring Cloud 版本之間對齊，例如 1.8.1-Hoxton.SR12 和 1.8.1-2021.0.3 ，SCT 版本號都是 1.8.1，功能完全對齊，只是引用的 Spring Cloud 不同。版本號中引入 Spring Cloud 版本為了一眼就能識別 Spring Cloud 版本對應(yīng)關(guān)系。開發(fā)者優(yōu)先選擇跟自己版本一致的 Spring Cloud 版本，再選擇最新的 SCT 版本。

使用 SCT 各個子模塊的功能，請參考 SCT Github Wiki 文檔。

三、 呼吁

第三方基礎(chǔ)組件的升級節(jié)奏會直接影響上層應(yīng)用的升級，在此也呼吁第三方基礎(chǔ)組件的維護者能夠盡快跟進適配。為廣大愿意嘗鮮的開發(fā)者和企業(yè)提供便利。

四、歡迎共建

如果您對微服務(wù)、Spring Cloud 技術(shù)感興趣，歡迎加入我們。您的一個建議、Issue、Pull Request 甚至只是一個小小的 Star 都是對 Spring Cloud Tencent 社區(qū)極大的支持。

審核編輯 ：李倩