引言
随着 Spring Boot 与 Spring Cloud 生态的持续迭代，Spring Cloud Alibaba 会同步更新版本，以保证生态兼容性、新增特性并修复漏洞。版本适配是搭建微服务项目的核心前提，错误的版本组合会导致项目启动失败、组件不兼容等问题
注意：由于版本更新频繁，请上官网查询最新版本发布声明
2021.x 版本系列
该版本系列为维护模式，仅修复漏洞，不再新增功能，适配 Spring Boot 2.4 - 2.6 、Spring Cloud 2020.0.x / 2021.0.x 版本。表格按版本从新到旧排序，标注 * 的为官方推荐使用版本。
Spring Cloud Alibaba Version | Spring Cloud Version | Spring Boot Version |
|---|
2021.0.6.0* | Spring Cloud 2021.0.5 | 2.6.13 |
2021.0.5.0 | Spring Cloud 2021.0.5 | 2.6.13 |
2021.0.4.0 | Spring Cloud 2021.0.4 | 2.6.11 |
2021.0.1.0 | Spring Cloud 2021.0.1 | 2.6.3 |
2021.1 | Spring Cloud 2020.0.1 | 2.4.2 |
组件版本关系
表格为各版本对应的官方默认集成组件版本，其中 ~ 代表该版本未默认集成对应组件：
Spring Cloud Alibaba Version | Sentinel Version | Nacos Version | RocketMQ Version | Dubbo Version | Seata Version |
|---|
2021.0.6.0 | 1.8.6 | 2.2.0 | 4.9.4 | ~ | 1.6.1 |
2021.0.5.0 | 1.8.6 | 2.2.0 | 4.9.4 | ~ | 1.6.1 |
2021.0.4.0 | 1.8.5 | 2.0.4 | 4.9.4 | ~ | 1.5.2 |
2021.0.1.0 | 1.8.3 | 1.4.2 | 4.9.2 | ~ | 1.4.2 |
2021.1 or 2.2.5.RELEASE or 2.1.4.RELEASE or 2.0.4.RELEASE | 1.8.0 | 1.4.1 | 2.4.0 | 2.7.8 | 1.3.0 |
2022.x 版本系列
该版本系列为废弃版本，生命周期极短，已停止所有维护，仅用于早期 Spring Boot 3.0 技术预览，不建议生产环境使用，适配 Spring Boot 3.0、Spring Cloud 2022.0.x 版本。
Spring Cloud Alibaba Version | Spring Cloud Version | Spring Boot Version |
|---|
2022.0.0.0* | Spring Cloud 2022.0.0 | 3.0.2 |
2022.0.0.0-RC2 | Spring Cloud 2022.0.0 | 3.0.2 |
2022.0.0.0-RC1 | Spring Cloud 2022.0.0 | 3.0.0 |
组件版本关系
Spring Cloud Alibaba Version | Sentinel Version | Nacos Version | RocketMQ Version | Seata Version |
|---|
2022.0.0.0 | 1.8.6 | 2.2.1 | 4.9.4 | 1.7.0 |
2022.0.0.0-RC2 | 1.8.6 | 2.2.1 | 4.9.4 | 1.7.0-native-rc2 |
2022.0.0.0-RC1 | 1.8.6 | 2.2.1-RC | 4.9.4 | 1.6.1 |
2023.x 版本系列
该版本系列是当前最新稳定版，为官方主推的生产环境首选版本，适配 Spring Boot 3.2、Spring Cloud 2023.0.x 版本，全面支持云原生、GraalVM 原生镜像等新特性。
Spring Cloud Alibaba Version | Spring Cloud Version | Spring Boot Version |
|---|
2023.0.1.0* | Spring Cloud 2023.0.1 | 3.2.4 |
2023.0.0.0-RC1 | Spring Cloud 2023.0.0 | 3.2.0 |
组件版本关系
Spring Cloud Alibaba Version | Sentinel Version | Nacos Version | RocketMQ Version | Seata Version |
|---|
2023.0.1.0 | 1.8.6 | 2.3.2 | 5.1.4 | 2.0.0 |
2023.0.0.0-RC1 | 1.8.6 | 2.3.0 | 5.1.4 | 2.0.0 |
版本选型建议
新项目优先选择 2023.0.1.0 最新稳定版，适配 Spring Boot 3.2，享受最新特性与官方维护；
老旧项目升级可选择 2021.0.6.0 维护版，兼容 Spring Boot 2.6，无架构改造成本；
严禁使用 2022.x 系列版本，避免因版本废弃引发生产问题；
组件版本严格遵循官方对应关系，禁止随意修改，防止兼容性冲突。
