运行Docker镜像时出现JNI错误：缺失Kafka Consumer类问题排查

问题根源 #

你当前用gradle build生成的jar是瘦包——只包含业务代码本身，所有通过implementation引入的依赖（包括kafka-clients这类传递依赖）都不会被打包进去。Docker容器运行时，JVM找不到这些依赖类，就会抛出NoClassDefFoundError。

解决方案 #

需要修改Gradle配置，打包时把所有依赖一起打进jar（生成胖包），以下两种方案二选一：

方案1：如果是Spring Boot项目（你依赖了spring-boot-starter-web）

直接用Spring Boot官方Gradle插件生成可执行胖包：

1. 修改build.gradle，添加Spring Boot插件及配置：

plugins {
    id 'java'
    id 'org.springframework.boot' version '2.7.14' // 版本需与spring-boot-starter-web匹配
    id 'io.spring.dependency-management' version '1.0.15.RELEASE'
}

// 原有依赖配置保持不变

// 指定主类全路径，比如com.example.MyConsumerApp
bootJar {
    mainClassName = '你的主类完整包名+类名'
}

2. 执行打包命令：

gradle clean bootJar

生成的胖包在build/libs目录下，文件名一般是{项目名}-{版本号}.jar，Dockerfile无需修改（ADD build/libs/*.jar parallel.jar会自动匹配这个胖包）。

方案2：普通Java项目（非Spring Boot）

用Gradle的Shadow插件打包胖包：

1. 修改build.gradle，添加Shadow插件及配置：

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

// 原有依赖配置保持不变

// 指定主类全路径
shadowJar {
    mainClassName = '你的主类完整包名+类名'
}

2. 执行打包命令：

gradle clean shadowJar

生成的胖包在build/libs目录下，文件名会带有-all后缀（比如{项目名}-all.jar），修改Dockerfile的ADD指令：

ADD build/libs/*-all.jar parallel.jar

额外检查 #

执行以下命令确认kafka-clients依赖是否存在（parallel-consumer-core应该会自动引入传递依赖，如果没有则手动添加）：

gradle dependencies

如果找不到kafka-clients，在build.gradle中手动添加：

implementation 'org.apache.kafka:kafka-clients:2.8.2' // 版本与parallel-consumer-core兼容即可

可选优化 #

Dockerfile中的RUN bash -c 'touch /parallel.jar'毫无意义，可以直接删除。

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