Spring Boot - NoClassDefFoundError: ch/qos/logback/classic/Level

问题概述

NoClassDefFoundError: ch/qos/logback/classic/Level 是一个常见的Java错误，通常发生在Spring Boot应用程序启动时。这个错误表明JVM在运行时无法找到某个类。

基础概念

NoClassDefFoundError: 这是Java中的一个错误类型，表示JVM在编译时能找到某个类，但在运行时找不到该类。
ch/qos/logback/classic/Level: 这是Logback日志框架中的一个类，用于定义日志级别。

原因

依赖缺失: 项目中缺少Logback相关的依赖。
版本冲突: 项目中存在多个版本的Logback或其他日志框架（如Log4j），导致冲突。
类路径问题: 编译后的类文件没有正确地包含在运行时的类路径中。

解决方法

1. 添加Logback依赖

确保你的pom.xml（如果你使用Maven）或build.gradle（如果你使用Gradle）中包含Logback的依赖。

Maven:

<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.2.10</version>
</dependency>

Gradle:

implementation 'ch.qos.logback:logback-classic:1.2.10'

2. 检查版本冲突

使用Maven或Gradle的依赖树工具来检查是否有版本冲突。

Maven:

mvn dependency:tree

Gradle:

./gradlew dependencies

如果发现冲突，可以尝试排除冲突的依赖或显式指定所需的版本。

3. 确保类路径正确

确保编译后的类文件和依赖库都包含在运行时的类路径中。如果你使用的是IDE（如IntelliJ IDEA或Eclipse），确保项目配置正确。

示例代码

假设你使用的是Maven，以下是一个简单的Spring Boot应用程序示例：

pom.xml:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.5.4</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>11</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.2.10</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

src/main/java/com/example/demo/DemoApplication.java:

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}