Spring Cloud Config Server运行Native配置时抛出NoClassDefFoundError异常

这个报错我之前帮不少开发者排查过，本质是默认的Spring Cloud Config Server依赖包含了Git相关组件，但当你启用native配置文件（用本地文件夹存储配置）时，这些Git组件的依赖没完全引入，或者你没正确禁用Git相关的自动配置。下面给你几个靠谱的解决办法：

方法1：排除Git相关依赖 #

如果你确定只用native模式，直接在构建文件里排除Spring Cloud Config Server自带的Git依赖：

Maven示例： #

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-config-server</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.eclipse.jgit</groupId>
            <artifactId>org.eclipse.jgit</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Gradle示例： #

implementation('org.springframework.cloud:spring-cloud-config-server') {
    exclude group: 'org.eclipse.jgit', module: 'org.eclipse.jgit'
}

方法2：显式引入Native配置专属依赖 #

部分版本的Spring Cloud Config Server中，native模式需要额外引入专属依赖来保证功能正常，你可以添加以下依赖：

Maven示例： #

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-config-server-native</artifactId>
</dependency>

方法3：禁用Git自动配置 #

在你的启动类上添加注解，强制禁用Git相关的自动配置，这样Spring就不会去加载JGit的类了：

import org.springframework.cloud.config.server.config.GitRepositoryConfiguration;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.cloud.config.server.EnableConfigServer;
import org.springframework.boot.SpringApplication;

@EnableConfigServer
@EnableAutoConfiguration(exclude = {GitRepositoryConfiguration.class})
public class ConfigServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(ConfigServerApplication.class, args);
    }
}

额外检查项 #

• 确认你的配置文件里正确开启了native模式并指定了本地配置路径：

  spring:
    profiles:
      active: native
    cloud:
      config:
        server:
          native:
            search-locations: file:///Users/yourname/config-files/ # 替换成你的本地配置文件夹实际路径
  

• 检查Spring Cloud与Spring Boot的版本兼容性，版本不匹配也可能导致这类依赖缺失问题。

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