Logback从1.2.9升级到1.3.4遇NoClassDefFoundError问题求助

核心原因 #

Logback 1.3.x 是为 SLF4J 2.x 设计的，而 SLF4J 2.x 彻底移除了 org.slf4j.impl.StaticLoggerBinder 类——这个类是SLF4J 1.x时代绑定日志实现的核心类。你的错误本质是依赖版本冲突：

• Spring Boot Starter（如spring-boot-starter-web）默认依赖的SLF4J版本与你手动指定的SLF4J 2.x不匹配；
• 仅在testImplementation中声明Logback 1.3.x和SLF4J 2.x，导致主代码类路径仍存在旧版SLF4J，测试时类加载出现矛盾。

解决方案 #

1. 统一依赖版本与范围 #

不要将Logback和SLF4J仅限定在测试依赖中，确保整个项目使用一致的版本：

dependencies {
    implementation('org.springframework.boot:spring-boot-starter-web')

    // 移除手动指定的slf4j-api，让Spring Boot依赖管理自动匹配兼容版本
    implementation('ch.qos.logback:logback-classic:1.3.4')
    implementation('ch.qos.logback:logback-core:1.3.4')

    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

2. 适配Spring Boot版本 #

• 若使用Spring Boot 3.x：它默认兼容SLF4J 2.x，上述配置即可正常工作；
• 若使用Spring Boot 2.x：需升级到Spring Boot 2.7+（该版本开始支持SLF4J 2.x），否则只能将Logback降级回1.2.x版本。

3. 排查并排除依赖冲突 #

运行以下命令查看依赖树，确认是否有旧版SLF4J被引入：

./gradlew dependencies

如果发现SLF4J 1.x版本的依赖，直接从Spring Boot Starter中排除：

implementation('org.springframework.boot:spring-boot-starter-web') {
    exclude group: 'org.slf4j', module: 'slf4j-api'
}

4. 验证SPI绑定 #

Logback 1.3.x通过SLF4J 2.x的SPI机制自动完成绑定，无需手动配置StaticLoggerBinder。只需确保logback-classic的jar包中存在META-INF/services/org.slf4j.spi.SLF4JServiceProvider文件，里面指向ch.qos.logback.classic.spi.LogbackServiceProvider即可。

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