Spring Cloud配置服务器启动失败：处理配置类导入候选失败

嘿，作为Spring新手碰到这个问题很正常，我来帮你捋清楚怎么解决～

你遇到的BeanDefinitionStoreException本质是找不到WebMvcConfigurerAdapter.class，这个类在Spring 5.0及之后的版本就被废弃，Spring Boot 2.0+更是直接移除了它，所以大概率是你的版本兼容出了问题，或者代码/依赖里还在引用这个旧类。

下面是具体的解决步骤：

• 首先确认Spring Boot和Spring Cloud的版本匹配：不同版本的Spring Boot对应特定的Spring Cloud版本，比如Spring Boot 3.x要搭配Spring Cloud 2022.0.x（Kilburn），Spring Boot 2.7.x对应Spring Cloud 2021.0.x（Jubilee）。版本不兼容很容易引发这类依赖冲突，你可以去检查pom.xml（Maven）或者build.gradle（Gradle）里的版本配置。
• 替换代码中对WebMvcConfigurerAdapter的引用：如果你的项目里自己写了继承这个类的Web配置类，直接改成实现WebMvcConfigurer接口就行。Spring 5+给这个接口加了默认方法，不用再继承适配器类。比如：
  原来的代码：

  public class CustomWebConfig extends WebMvcConfigurerAdapter {
      // 重写的配置方法
  }
  

  修改后：

  public class CustomWebConfig implements WebMvcConfigurer {
      // 直接实现你需要的配置方法即可
  }
  

• 排查并解决依赖冲突：用依赖分析命令找出哪个组件在引入旧版本的spring-webmvc。Maven可以用mvn dependency:tree，Gradle用./gradlew dependencies。如果发现某个第三方依赖带了旧版本，就把它排除掉。比如Maven里的排除写法：

  <dependency>
      <groupId>第三方依赖groupId</groupId>
      <artifactId>第三方依赖artifactId</artifactId>
      <exclusions>
          <exclusion>
              <groupId>org.springframework</groupId>
              <artifactId>spring-webmvc</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 确保Config Server依赖正确：你的配置服务器要引入正确的starter，并且通过Spring Cloud的依赖管理来统一版本，避免手动指定版本导致的问题。Maven的依赖示例：

  <dependencyManagement>
      <dependencies>
          <dependency>
              <groupId>org.springframework.cloud</groupId>
              <artifactId>spring-cloud-dependencies</artifactId>
              <version>你的Spring Cloud版本</version>
              <type>pom</type>
              <scope>import</scope>
          </dependency>
      </dependencies>
  </dependencyManagement>
  
  <dependencies>
      <dependency>
          <groupId>org.springframework.cloud</groupId>
          <artifactId>spring-cloud-config-server</artifactId>
      </dependency>
  </dependencies>
  

按照上面的步骤一步步排查调整，应该就能顺利启动你的配置服务器啦～

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