运行含Apache Kafka依赖的JAR文件时出现NoClassDefFoundError求助

问题根源 #

NoClassDefFoundError表明JVM在运行时找不到org.apache.kafka.clients.consumer.KafkaConsumer类，核心原因有两点：

• 类路径路径不匹配：你在清单中指定的Class-Path是libs/kafka-clients-3.3.1.jar，但运行时该Jar文件并未放置在应用Jar所在目录的libs子目录下，导致JVM无法定位类文件。
• 未处理传递依赖：kafka-clients本身依赖slf4j-api、kafka-common等其他Jar包，直接依赖本地Jar时Gradle不会自动下载这些依赖，即使解决了路径问题，后续仍会出现其他类缺失的错误。

解决方案 #

方案1：使用Maven Central官方依赖（推荐） #

替换本地Jar依赖为Maven Central的官方依赖，Gradle会自动下载并管理所有依赖（包括传递依赖）：
修改build.gradle的dependencies块：

dependencies {
    implementation 'net.openhft:chronicle-map:3.24ea1'
    // 替换本地Jar为Maven Central的kafka-clients依赖
    implementation 'org.apache.kafka:kafka-clients:3.3.1'
}

方案2：利用Application插件生成可执行分发包 #

Application插件会自动处理依赖类路径，生成包含所有依赖的运行脚本：

1. 执行Gradle任务生成分发包：

./gradlew installDist

2. 运行生成的脚本：

# Linux/macOS
build/install/[你的项目名称]/bin/[你的项目名称]

# Windows
build\install\[你的项目名称]\bin\[你的项目名称].bat

方案3：打包成包含所有依赖的胖包（Shadow Jar） #

若需要单个可执行Jar，使用Shadow插件将所有依赖打包进同一个Jar：

1. 在build.gradle顶部添加Shadow插件：

plugins {
    id 'application'
    id 'java'
    id 'com.github.johnrengelman.shadow' version '7.1.2'
}

2. 执行打包任务：

./gradlew shadowJar

3. 运行生成的胖包：

java -jar build/libs/[你的项目名称]-all.jar

方案4：修复现有Class-Path配置（不推荐） #

若坚持使用本地Jar，需手动维护所有依赖：

1. 将kafka-clients-3.3.1.jar及所有传递依赖Jar（如slf4j-api、kafka-common等）放置在应用Jar所在目录的libs子目录下。
2. 更新build.gradle的jar配置，将所有依赖Jar添加到Class-Path：

jar {
    manifest {
        attributes(
            'Main-Class': 'com.blockonic.balances.ChronicleMapWebSocketServer',
            'Class-Path': 'libs/kafka-clients-3.3.1.jar libs/slf4j-api-1.7.36.jar libs/kafka-common-3.3.1.jar'
        )
    }
}

此方式需手动跟踪所有依赖，维护成本高，不推荐。

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