Spring Boot 2.7.9兼容hystrix版本选择及ClassNotFoundException报错排查

核心错误点 #

你犯了两个关键错误：

1. 版本映射关系错误：Spring Cloud 2021.0.x（Jubilee）对应的Spring Cloud Netflix组件版本并非2.x系列，而是3.1.x系列。你错误地将Spring Cloud的大版本号直接等价于Netflix组件的旧版本号，导致选用了不兼容的Hystrix版本。
2. 旧版Hystrix依赖已移除的类：org.springframework.boot.context.properties.ConfigurationBeanFactoryMetadata这个类在Spring Boot 2.4及之后的版本中已被移除，而2.x系列的Hystrix依赖该类，因此在Spring Boot 2.7.9环境下必然会抛出ClassNotFoundException。

正确的解决方案 #

1. 依赖管理优先使用Spring Cloud BOM #

不要手动指定Hystrix的版本，通过引入Spring Cloud的依赖管理BOM来自动对齐所有组件版本，这是Spring Cloud官方推荐的方式。在你的pom.xml中添加如下配置：

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

然后直接引入Hystrix依赖即可，无需指定版本：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-hystrix</artifactId>
</dependency>

2. 手动指定版本的正确值 #

如果必须手动指定版本，Spring Cloud 2021.0.3对应的spring-cloud-starter-netflix-hystrix版本为3.1.3.RELEASE，该版本已适配Spring Boot 2.6.x/2.7.x，不会依赖已移除的ConfigurationBeanFactoryMetadata类。

3. 清理无效依赖配置 #

检查你的项目依赖，确保没有同时引入多个版本的Hystrix或Spring Cloud组件，避免版本冲突。可以通过mvn dependency:tree命令查看依赖树，排查冲突并排除冗余依赖。

内容的提问来源于stack exchange，提问作者Gestalt