spring boot与spring cloud版本兼容问题解决（附版本兼容表）

天行健，君子以自强不息；地势坤，君子以厚德载物。

---

每个人都有惰性，但不断学习是好好生活的根本，共勉！

---

文章均为学习整理笔记，分享记录为主，如有错误请指正，共同学习进步。

以下为解决报错问题，如果看完还不能解决，可以参考下面这篇文章搭建spring cloud
spring cloud搭建

1. 场景描述（产生环境）

在基于spring boot搭建spring cloud时，创建eureka后启动服务发生报错，报错内容如下，如觉得繁琐可直接看第三步解决方法进行尝试，或可直接解决问题。
注： 使用zuul的场景有些特殊，所以放在最后讲，如果是zuul使用的报错请移步5

2. 报错代码（控制台）

2.1 报错1

Error creating bean with name 'configurationPropertiesBeans' defined in class path resource [org/springframework/cloud/autoconfigure/ConfigurationPropertiesRebinderAutoConfiguration.class]: Bean

试了几次，有时候还会出现下面的报错-报错2

2.2 报错2

Could not find artifact org.springframework.cloud:spring-cloud-starter-netflix-eureka-server:pom:2021.0.5 in alimaven (http://maven.aliyun.com/nexus/content/groups/public/)

两个版本都能对应上之后启动项目又出现了新的报错-报错3

2.3 报错3

org.springframework.cloud:spring-cloud-starter-netflix-eureka-server:jar:unknown was not found in http://maven.aliyun.com/nexus/content/groups/public/ during a previous attempt. This failure was cached in the local repository and resolution is not reattempted until the update interval of alimaven has elapsed or updates are forced

如果报错3的问题也解决了，这个时候使用的两个不兼容的版本，如果刷新依赖也没报错的话，启动项目后正常会报下面的错，如报错4

2.4 报错4

使用springboot2.7.3和springcloud2020.0.5后启动项目出现如下报错

Action:

Consider applying the following actions:

- Change Spring Boot version to one of the following versions [2.4.x, 2.5.x] .
You can find the latest Spring Boot versions here [https://spring.io/projects/spring-boot#learn]. 
If you want to learn more about the Spring Cloud Release train compatibility, you can visit this page [https://spring.io/projects/spring-cloud#overview] and check the [Release Trains] section.
If you want to disable this check, just set the property [spring.cloud.compatibility-verifier.enabled=false]

---

3. 解决方法

3.1 针对报错1、报错2、报错4的解决

百度后确定是版本不兼容问题，于是按照网上某博主版本列表配对，本章末尾附版本对照表可供参考。

我使用的版本是spring boot的2.7.3以及spring cloud的2021.0.5
还试了
spring boot的2.5.3以及spring cloud的2020.0.5
spring boot的2.1.4.RELEASE以及spring cloud的Greenwich.RELEASE
这三个版本都是亲测可用的（顺利起了服务并访问成功）

3.2 针对报错3的解决

版本确定没配错，那么这个报错3如果发生了，可以按照如下解决
在依赖中添加type和scope标签，如下
在父类pom.xml中配置如下

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.3</version>
    </parent>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>2021.0.5</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

虽然不知道原理，但的确解决了报错3这个问题

4. 总结

正常版本兼容问题常常发生，所以一般使用偏老一点的依赖来用会减少一些问题，但很多情况下即使使用老的版本也会出现问题。
只要按照下面的方式来配置一般不会有毛病。
父项目pom.xml中的配置添加如下：

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.3</version>
    </parent>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                    <version>2021.0.5</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

子模块项目的pom.xml配置如下：

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
        </dependency>
    </dependencies>

5. zuul使用的报错与解决

使用兼容列表里对应的spring boot和spring cloud版本后，springcloud中的eureka等其他功能正常，但使用zuul时启动zuul服务后出现了报错，此时可尝试使用以下两个版本：spring boot 的2.2.4.RELEASE和spring cloud 的Hoxton.SR12一般可解决问题
我遇到的是如下报错：

org.springframework.cloud:spring-cloud-starter-netflix-zuul:jar:unknown was not found in http://maven.aliyun.com/nexus/content/groups/public/ during a previous attempt. This failure was cached in the local repository and resolution is not reattempted until the update interval of alimaven has elapsed or updates are forced

或者以下报错：

Error creating bean with name 'configurationPropertiesBeans' defined in class path resource [org/springframework/cloud/autoconfigure/ConfigurationPropertiesRebinderAutoConfiguration.class]: Post-processing of merged bean definition failed; nested exception is java.lang.IllegalStateException: Failed to introspect Class [org.springframework.cloud.context.properties.ConfigurationPropertiesBeans] from ClassLoader [sun.misc.Launcher$AppClassLoader@18b4aac2]

以上两个报错都可将springboot和spring cloud的版本换为上面推荐的2.2.4.RELEASE和Hoxton.SR12即可解决问题

6. spring boot和spring cloud版本兼容表

这是参考的一位博主的表格，对于更详细的版本介绍请移步这位博主的文章：spring cloud版本介绍

SpringCloud版本	SpringBoot版本
2022.0.0-M2	Spring Boot >=3.0.0-M2 and < 3.1.0-M1
2022.0.0-M1	Spring Boot >=3.0.0-M1 and < 3.0.0-M2
2021.0.3	Spring Boot >=2.6.1 and < 3.0.0-M1
2021.0.0-RC1	Spring Boot >=2.6.0-RC1 and <2.6.1
2021.0.0-M3	Spring Boot >=2.6.0-M3 and <2.6.0-RC1
2021.0.0-M1	Spring Boot >=2.6.0-M1 and <2.6.0-M3
2020.0.5	Spring Boot >=2.4.0.M1 and <2.6.0-M1
Hoxton.SR12	Spring Boot >=2.2.0.RELEASE and <2.4.0.M1
Hoxton.BUILD-SNAPSHOT	Spring Boot >=2.2.0.BUILD-SNAPSHOT
Hoxton.M2	Spring Boot >=2.2.0.M4 and <=2.2.0.M5
Greenwich.BUILD-SNAPSHO	Spring Boot >=2.1.9.BUILD-SNAPSHOT and <2.2.0.M4
Greenwich.SR2	Spring Boot >=2.1.0.RELEASE and <2.1.9.BUILD-SNAPSHOT
Greenwich.M1	Spring Boot >=2.1.0.M3 and <2.1.0.RELEASE
Finchley.BUILD-SNAPSHOT	Spring Boot >=2.0.999.BUILD-SNAPSHOT and <2.1.0.M3
Finchley.SR4	Spring Boot >=2.0.3.RELEASE and <2.0.999.BUILD-SNAPSHOT
Finchley.RC2	Spring Boot >=2.0.2.RELEASE and <2.0.3.RELEASE
Finchley.RC1	Spring Boot >=2.0.1.RELEASE and <2.0.2.RELEASE
Finchley.M9	Spring Boot >=2.0.0.RELEASE and <=2.0.0.RELEASE
Finchley.M7	Spring Boot >=2.0.0.RC2 and <=2.0.0.RC2
Finchley.M6	Spring Boot >=2.0.0.RC1 and <=2.0.0.RC1
Finchley.M5	Spring Boot >=2.0.0.M7 and <=2.0.0.M7
Finchley.M4	Spring Boot >=2.0.0.M6 and <=2.0.0.M6
Finchley.M3	Spring Boot >=2.0.0.M5 and <=2.0.0.M5
Finchley.M2	Spring Boot >=2.0.0.M3 and <2.0.0.M5
Edgware.SR5	1.5.20.RELEASE
Edgware.SR5	1.5.16.RELEASE
Edgware.RELEASE	1.5.9.RELEASE
Dalston.RC1	1.5.2.RELEASE