Docker容器运行时调用Thrift类引发Gradle依赖缺失（NoClassDefFoundError）

问题现象 #

使用Docker和Gradle构建Java应用，构建成功但运行容器时，程序在实例化BankThriftHandler时抛出NoClassDefFoundError: org/apache/thrift/transport/TTransportException，提示Apache Thrift相关类找不到。

相关代码与配置 #

Dockerfile内容：

FROM nginx:latest
RUN apt-get update && apt-get install -y openjdk-11-jdk
RUN mkdir "Verteiltes_System"
WORKDIR "Verteiltes_System"
COPY src/main/java/Bank/src/* src/main/java/Bank/src/
COPY src/main/java/TCP/src/* src/main/java/TCP/src/
COPY src/main/java/Stock/* src/main/java/Stock/
COPY src/main/java/Thrift/* src/main/java/Thrift/
COPY src/* src/
COPY build/libs/* build/libs/


COPY .gradle .gradle
COPY gradlew .
COPY gradle gradle


COPY build.gradle .

RUN ./gradlew build

src/main/java/Bank/src/BankTCP.java src/main/java/Bank/src/ClientHandler.java src/main/java/Bank/src/Bank.java
CMD ["java", "-cp", "build/classes/java/main/Stock:build/classes/java/main/TCP/src:build/classes/java/main/Bank/src:build/classes/java/main/", "Bank.src.Bank"]

Bank类调用BankThriftHandler的代码：

public Bank(String name) {
    this.name = name;
    this.securities = new HashMap<>();
    this.reserves = 1000000;
    this.isBankrupt = false;
    setTotalValue();

    try {
        bankThriftHandler = new BankThriftHandler(this);
        bankThriftHandler.start();
    } catch (Exception e) {
        e.printStackTrace();
    }
}

BankThriftHandler的导入：

import org.apache.thrift.TException;
import org.apache.thrift.protocol.TBinaryProtocol;
import org.apache.thrift.protocol.TProtocol;
import org.apache.thrift.server.TServer;
import org.apache.thrift.server.TSimpleServer;
import org.apache.thrift.transport.*;

错误信息：

NoClassDefFoundError: org/apache/thrift/transport/TTransportException.

问题原因 #

1. 运行时类路径缺失依赖：Gradle编译时会自动下载Apache Thrift依赖，但运行java命令的-cp参数只包含了项目自身的编译类，未包含Thrift的依赖Jar包，导致运行时找不到对应类。
2. Dockerfile存在无效指令：src/main/java/Bank/src/BankTCP.java ...这一行无指令前缀，属于无效语句，不会被执行。
3. 基础镜像冗余：使用nginx:latest作为基础镜像完全没必要，应用是Java程序，无需Nginx服务，徒增镜像体积。

解决方案 #

方案一：使用Gradle生成包含所有依赖的可执行Jar（推荐） #

通过Gradle的shadowJar插件将所有依赖打包到一个Jar里，运行时直接执行该Jar即可，无需手动配置类路径。

1. 修改build.gradle，添加shadowJar插件

plugins {
    id 'java'
    id 'com.github.johnrengelman.shadow' version '7.1.2' // 版本可根据Gradle版本调整
}

// 配置主类全限定名
shadowJar {
    mainClassName = 'Bank.src.Bank'
}

// 让build任务自动触发shadowJar打包
build.dependsOn shadowJar

2. 修改Dockerfile

# 使用轻量的OpenJDK11 JRE作为基础镜像
FROM openjdk:11-jre-slim

WORKDIR /app

# 仅复制构建所需的核心文件
COPY gradlew .
COPY gradle gradle
COPY build.gradle .
COPY src src

# 构建项目，生成包含所有依赖的胖Jar
RUN ./gradlew shadowJar

# 运行胖Jar（替换成实际生成的Jar文件名，格式一般为[项目名]-all.jar）
CMD ["java", "-jar", "build/libs/your-project-name-all.jar"]

方案二：手动将依赖加入运行时类路径 #

若不想打包成胖Jar，可在运行时将Gradle下载的依赖Jar加入类路径。

1. 修改Dockerfile

删除无效的src/main/java/Bank/src/BankTCP.java ...语句，然后修改最后部分：

RUN ./gradlew build

# 创建目录存放依赖Jar，拷贝Thrift依赖到该目录
RUN mkdir -p libs
RUN cp ~/.gradle/caches/modules-2/files-2.1/org.apache.thrift/libthrift/*/*.jar libs/

# 运行时类路径包含项目编译类+Thrift依赖Jar
CMD ["java", "-cp", "build/classes/java/main/Stock:build/classes/java/main/TCP/src:build/classes/java/main/Bank/src:build/classes/java/main/:libs/*", "Bank.src.Bank"]

额外优化建议 #

• 减少镜像层数：合并多个RUN命令，降低镜像构建复杂度。
• 避免复制冗余文件：无需复制.gradle目录，./gradlew build会自动处理依赖下载，复制.gradle可能引发缓存问题。
• 多阶段构建减小体积：第一阶段用OpenJDK构建，第二阶段用JRE运行，仅复制必要文件：

# 构建阶段
FROM openjdk:11 as builder

WORKDIR /build

COPY gradlew .
COPY gradle gradle
COPY build.gradle .
COPY src src

RUN ./gradlew shadowJar

# 运行阶段
FROM openjdk:11-jre-slim

WORKDIR /app

# 从构建阶段复制生成的胖Jar
COPY --from=builder /build/build/libs/your-project-name-all.jar .

CMD ["java", "-jar", "your-project-name-all.jar"]

验证步骤 #

1. 执行docker build -t bank-app .构建镜像
2. 执行docker run -it bank-app运行容器
3. 检查是否仍出现NoClassDefFoundError错误

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