Spring Boot微服务引入Spring Cloud依赖启动时出现ClassNotFoundException

这个问题我之前也碰到过，核心原因是你使用的Spring Cloud里程碑版本（Finchley.M8）存在依赖缺失或者未同步到Maven中央仓库的问题，再加上版本匹配的细节没处理好，导致启动时找不到对应的类。

问题根源分析 #

1. 里程碑版本的不稳定性：Finchley.M8是预发布的里程碑版本，这类版本通常用于测试新特性，官方不会保证依赖的完整性和稳定性，很多时候相关的依赖jar包可能没有完全同步到公共Maven仓库，自然会出现ClassNotFound。
2. 版本匹配的细节：虽然Spring Boot 2.0.x确实对应Spring Cloud Finchley系列，但必须使用该系列的正式RELEASE版本，而不是M开头的里程碑版本。

具体解决方案 #

1. 替换Spring Cloud版本为正式版，并正确引入依赖管理BOM

首先在你的pom.xml中，确保通过dependencyManagement引入Spring Cloud的依赖管理BOM，这样能保证所有Spring Cloud组件的版本统一且兼容。把原来的Finchley.M8替换为Finchley.RELEASE：

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

2. 引入具体的Spring Cloud组件依赖

接下来在dependencies块中添加你需要的Feign或Zipkin Client依赖，不需要指定版本（BOM已经帮你管理好了）：

<dependencies>
    <!-- 基础Spring Boot Web依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- OpenFeign 依赖 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-openfeign</artifactId>
    </dependency>

    <!-- Zipkin Client 依赖（如果需要） -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-zipkin</artifactId>
    </dependency>
</dependencies>

3. 清理本地Maven仓库（可选但推荐）

如果之前已经下载过Finchley.M8的依赖，可能存在损坏或不完整的情况，建议删除本地Maven仓库中对应的Spring Cloud依赖目录（通常在~/.m2/repository/org/springframework/cloud），然后重新执行mvn clean install下载完整的正式版依赖。

补充说明 #

你提到Spring Initializr生成的项目也有这个问题，大概率是你在生成时选择了里程碑版本的Spring Cloud。现在Initializr默认会推荐稳定的正式版本，下次生成项目时注意选择Finchley.RELEASE或者更晚的稳定版（当然要和你的Spring Boot 2.0.x匹配）。

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