一、前言
在搭建SpringCloud項目環(huán)境架構(gòu)的時候，經(jīng)常需要選擇SpringBoot和SpringCloud進行兼容的版本號。因此，對于選擇SpringBoot版本與SpringCloud版本的對應(yīng)關(guān)系很重要，如果版本關(guān)系不對應(yīng)，常見的會遇見項目啟動不起來，怪異的則會是你的項目出現(xiàn)一些詭異的問題，查資料也不好查。下面就收集一下SpringBoot與SpringCloud版本之間的對應(yīng)關(guān)系，在搭建項目框架或者學(xué)習(xí)時按照對應(yīng)的版本區(qū)間進行選擇即可，避免走一些不必要的彎路。
1. 歷史版本圖
Release train Spring Boot compatibility
注意： 官方通告SpringBoot1.5.x及以下版本官方不再提供維護了，建議開發(fā)者選擇使用SpringBoot2.0.x以上的版本，相對應(yīng)的SpringCloud版本也最好不要使用。
二、查看版本關(guān)系
訪問Spring官方地址，可獲取SpringBoot和SpringCloud版本對應(yīng)信息。
地址如下：
https://start.spring.io/actuator/info
JSON格式如下：
{
"git": {
"branch": "aa1ad68ea9a0eac4180037118854753f3e200e85",
"commit": {
"id": "aa1ad68",
"time": "2023-03-10T15:26:12Z"
}
},
"build": {
"version": "0.0.1-SNAPSHOT",
"artifact": "start-site",
"versions": {
"spring-boot": "3.0.2",
"initializr": "0.20.0-SNAPSHOT"
},
"name": "start.spring.io website",
"time": "2023-03-10T15:27:19.222Z",
"group": "io.spring.start"
},
"bom-ranges": {
"codecentric-spring-boot-admin": {
"2.4.3": "Spring Boot >=2.3.0.M1 and <2.5.0-M1",
"2.5.6": "Spring Boot >=2.5.0.M1 and <2.6.0-M1",
"2.6.8": "Spring Boot >=2.6.0.M1 and <2.7.0-M1",
"2.7.4": "Spring Boot >=2.7.0.M1 and <3.0.0-M1",
"3.0.0-M4": "Spring Boot >=3.0.0-M1 and <3.1.0-M1"
},
"solace-spring-boot": {
"1.1.0": "Spring Boot >=2.3.0.M1 and <2.6.0-M1",
"1.2.2": "Spring Boot >=2.6.0.M1 and <3.0.0-M1"
},
"solace-spring-cloud": {
"1.1.1": "Spring Boot >=2.3.0.M1 and <2.4.0-M1",
"2.1.0": "Spring Boot >=2.4.0.M1 and <2.6.0-M1",
"2.3.2": "Spring Boot >=2.6.0.M1 and <3.0.0-M1"
},
"spring-cloud": {
"Hoxton.SR12": "Spring Boot >=2.2.0.RELEASE and <2.4.0.M1",
"2020.0.6": "Spring Boot >=2.4.0.M1 and <2.6.0-M1",
"2021.0.0-M1": "Spring Boot >=2.6.0-M1 and <2.6.0-M3",
"2021.0.0-M3": "Spring Boot >=2.6.0-M3 and <2.6.0-RC1",
"2021.0.0-RC1": "Spring Boot >=2.6.0-RC1 and <2.6.1",
"2021.0.6": "Spring Boot >=2.6.1 and <3.0.0-M1",
"2022.0.0-M1": "Spring Boot >=3.0.0-M1 and <3.0.0-M2",
"2022.0.0-M2": "Spring Boot >=3.0.0-M2 and <3.0.0-M3",
"2022.0.0-M3": "Spring Boot >=3.0.0-M3 and <3.0.0-M4",
"2022.0.0-M4": "Spring Boot >=3.0.0-M4 and <3.0.0-M5",
"2022.0.0-M5": "Spring Boot >=3.0.0-M5 and <3.0.0-RC1",
"2022.0.0-RC1": "Spring Boot >=3.0.0-RC1 and <3.0.0-RC2",
"2022.0.0-RC2": "Spring Boot >=3.0.0-RC2 and <3.0.0",
"2022.0.1": "Spring Boot >=3.0.0 and <3.1.0-M1"
},
"spring-cloud-azure": {
"4.6.0": "Spring Boot >=2.5.0.M1 and <3.0.0-M1",
"5.0.0": "Spring Boot >=3.0.0-M1 and <3.1.0-M1"
},
"spring-cloud-gcp": {
"2.0.11": "Spring Boot >=2.4.0-M1 and <2.6.0-M1",
"3.4.6": "Spring Boot >=2.6.0-M1 and <3.0.0-M1",
"4.1.2": "Spring Boot >=3.0.0-M1 and <3.1.0-M1"
},
"spring-cloud-services": {
"2.3.0.RELEASE": "Spring Boot >=2.3.0.RELEASE and <2.4.0-M1",
"2.4.1": "Spring Boot >=2.4.0-M1 and <2.5.0-M1",
"3.3.0": "Spring Boot >=2.5.0-M1 and <2.6.0-M1",
"3.4.0": "Spring Boot >=2.6.0-M1 and <2.7.0-M1",
"3.5.0": "Spring Boot >=2.7.0-M1 and <3.0.0-M1",
"4.0.0": "Spring Boot >=3.0.0 and <3.1.0-M1"
},
"spring-shell": {
"2.1.6": "Spring Boot >=2.7.0 and <3.0.0-M1",
"3.0.0": "Spring Boot >=3.0.0 and <3.1.0-M1"
},
"vaadin": {
"14.9.6": "Spring Boot >=2.1.0.RELEASE and <2.6.0-M1",
"23.2.15": "Spring Boot >=2.6.0-M1 and <2.7.0-M1",
"23.3.5": "Spring Boot >=2.7.0-M1 and <3.0.0-M1",
"24.0.0": "Spring Boot >=3.0.0-M1 and <3.1.0-M1"
},
"hilla": {
"1.3.5": "Spring Boot >=2.7.0-M1 and <3.0.0-M1",
"2.0.0": "Spring Boot >=3.0.0-M1 and <3.1.0-M1"
},
"wavefront": {
"2.0.2": "Spring Boot >=2.1.0.RELEASE and <2.4.0-M1",
"2.1.1": "Spring Boot >=2.4.0-M1 and <2.5.0-M1",
"2.2.2": "Spring Boot >=2.5.0-M1 and <2.7.0-M1",
"2.3.4": "Spring Boot >=2.7.0-M1 and <3.0.0-M1",
"3.0.1": "Spring Boot >=3.0.0-M1 and <3.1.0-M1"
}
},
"dependency-ranges": {
"okta": {
"1.4.0": "Spring Boot >=2.2.0.RELEASE and <2.4.0-M1",
"1.5.1": "Spring Boot >=2.4.0-M1 and <2.4.1",
"2.0.1": "Spring Boot >=2.4.1 and <2.5.0-M1",
"2.1.6": "Spring Boot >=2.5.0-M1 and <3.0.0-M1",
"3.0.3": "Spring Boot >=3.0.0-M1 and <3.1.0-M1",
"managed": "Spring Boot >=3.1.0-M1"
},
"mybatis": {
"2.1.4": "Spring Boot >=2.1.0.RELEASE and <2.5.0-M1",
"2.2.2": "Spring Boot >=2.5.0-M1 and <2.7.0-M1",
"2.3.0": "Spring Boot >=2.7.0-M1 and <3.0.0-M1",
"3.0.0": "Spring Boot >=3.0.0-M1"
},
"camel": {
"3.5.0": "Spring Boot >=2.3.0.M1 and <2.4.0-M1",
"3.10.0": "Spring Boot >=2.4.0.M1 and <2.5.0-M1",
"3.13.0": "Spring Boot >=2.5.0.M1 and <2.6.0-M1",
"3.17.0": "Spring Boot >=2.6.0.M1 and <2.7.0-M1",
"3.20.2": "Spring Boot >=2.7.0.M1 and <3.0.0-M1",
"4.0.0-M2": "Spring Boot >=3.0.0-M1 and <3.1.0-M1"
},
"picocli": {
"4.7.0": "Spring Boot >=2.5.0.RELEASE and <3.1.0-M1"
},
"open-service-broker": {
"3.2.0": "Spring Boot >=2.3.0.M1 and <2.4.0-M1",
"3.3.1": "Spring Boot >=2.4.0-M1 and <2.5.0-M1",
"3.4.1": "Spring Boot >=2.5.0-M1 and <2.6.0-M1",
"3.5.0": "Spring Boot >=2.6.0-M1 and <2.7.0-M1"
}
}
}
三、如何選擇SpringBoot與SpringCloud版本號
項目搭建初期，如何對SpringBoot和SpringCloud的一個相互兼容性版本號進行選擇，這是很重要的一步，例如SpringCloud的Hoxton.SR3這個版本，他對應(yīng)的"Spring Boot >=2.2.0.M4 and <2.3.0.BUILD-SNAPSHOT"版本，意思就是如果選擇使用SpringCloud 的Hoxton.SR3這個版本，那么SpringBoot的版本需要大于等于2.2.0小于2.3.0即可滿足兼容性。
1. 引入SpringCloud版本管理
官方提供了管理Spring Cloud 每個版本兼容的pom，引入下面依賴管理信息即可：
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>Hoxton.SR3</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
2. 使用Spring Boot
Spring Boot可以也像父工程那樣管理自己內(nèi)部的兼容版本號，如下：
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.2.5.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
四、SpringBoot、SpringCloud、SpringCloudAlibaba版本對應(yīng)關(guān)系
由于Spring Cloud基于Spring Boot構(gòu)建，而Spring Cloud Alibaba又基于Spring Cloud Common的規(guī)范實現(xiàn)，所以當(dāng)我們使用``Spring Cloud Alibaba`來構(gòu)建微服務(wù)應(yīng)用的時候，需要知道這三者之間的版本關(guān)系。
下表整理了目前Spring Cloud Alibaba的版本與Spring Boot、Spring Cloud版本的兼容關(guān)系：
1. 畢業(yè)版本依賴關(guān)系(推薦使用)
五. Spring Cloud Alibaba與組件版本關(guān)系
Spring Cloud Alibaba是基于Spring Cloud Common的規(guī)范實現(xiàn)，而Spring Cloud Alibaba的各個微服務(wù)組件依賴于Spring Cloud Alibaba自身，因此我們需要知道Spring Cloud Alibaba與其自身微服務(wù)組件之間的版本關(guān)系。
下表整理了目前Spring Cloud Alibaba的版本與Sentinel、Nacos 、RocketMQ 、Dubbo、Seata版本的兼容關(guān)系：
1. 組件版本關(guān)系
六、依賴管理
Spring Cloud Alibaba BOM 包含了它所使用的所有依賴的版本。
1. RELEASE 版本
Spring Cloud Hoxton
如果需要使用 Spring Cloud Hoxton 版本，請在 dependencyManagement中添加如下配置
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>2.2.3.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
然后在dependencies 中添加自己所需使用的依賴即可使用。
Spring Cloud Greenwich
如果需要使用 Spring Cloud Greenwich版本，請在 dependencyManagement中添加如下配置
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>2.1.3.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
然后在 dependencies中添加自己所需使用的依賴即可使用。
Spring Cloud Finchley
如果需要使用 Spring Cloud Finchley版本，請在 dependencyManagement中添加如下配置
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>2.0.3.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
然后在dependencies中添加自己所需使用的依賴即可使用。
Spring Cloud Edgware
如果需要使用 Spring Cloud Edgware 版本，請在 dependencyManagement中添加如下配置
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>1.5.1.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
然后在 dependencies中添加自己所需使用的依賴即可使用。
2. 版本管理規(guī)范
項目的版本號格式為 x.x.x 的形式，其中 x 的數(shù)值類型為數(shù)字，從 0 開始取值，且不限于 0~9 這個范圍。項目處于孵化器階段時，第一位版本號固定使用 0，即版本號為 0.x.x 的格式。
由于 `Spring Boot 1 和 Spring Boot 2 在 Actuator 模塊的接口和注解有很大的變更，且 spring-cloud-commons 從 1.x.x 版本升級到 2.0.0 版本也有較大的變更，因此我們采取跟 SpringBoot 版本號一致的版本:
1.5.x 版本適用于 Spring Boot 1.5.x
2.0.x 版本適用于 Spring Boot 2.0.x
2.1.x 版本適用于 Spring Boot 2.1.x
2.2.x 版本適用于 Spring Boot 2.2.x
七、參考文檔
1.Spring-Cloud-Alibaba版本說明：
https://github.com/alibaba/spring-cloud-alibaba/wiki/版本說明
3.SpringCloudAlibaba中文社區(qū)地址:
https://github.com/alibaba/spring-cloud-alibaba/blob/master/README-zh.md文章來源：http://www.zghlxwxcb.cn/news/detail-725661.html
2.SpringCloud官方文檔：
https://cloud.spring.io/spring-cloud-static/spring-cloud-gateway/2.2.1.RELEASE/reference/html/文章來源地址http://www.zghlxwxcb.cn/news/detail-725661.html
到了這里，關(guān)于Spring Boot、Spring Cloud與Spring Cloud Alibaba版本對應(yīng)關(guān)系的文章就介紹完了。如果您還想了解更多內(nèi)容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！
