Docker容器中Kotlin应用出现ClassNotFoundException问题求助

核心问题分析 #

出现Could not find or load main class错误，主要源于以下几点：

• Linux容器中类路径分隔符需用冒号:，而非Windows环境的分号;，你的entrypoint.sh使用了错误的分隔符导致类路径解析失败
• Kotlin标准库kotlin-stdlib.jar未存在于容器当前目录，类路径无法找到依赖
• 构建的simulation-1.0.jar可能不包含Kotlin标准库等依赖，或者主类名称不正确（Kotlin顶层main函数编译后类名会自动添加Kt后缀）
• Dockerfile直接复制本地构建的jar包，易出现环境不一致导致的依赖缺失

具体解决方案 #

1. 修复类路径分隔符 #

修改entrypoint.sh中的分隔符，将分号替换为冒号：

java -cp "kotlin-stdlib.jar:simulation-1.0.jar" com.demo.app.simulation.Simulator

注：此修复仅解决分隔符问题，需额外确保kotlin-stdlib.jar存在于容器当前目录。

2. 构建包含所有依赖的Fat Jar（推荐方案） #

构建包含所有依赖（含Kotlin标准库）的可执行jar包，无需单独处理类路径。在Maven的pom.xml中添加以下插件：

<build>
    <plugins>
        <!-- Kotlin编译插件 -->
        <plugin>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-maven-plugin</artifactId>
            <version>${kotlin.version}</version>
            <executions>
                <execution>
                    <id>compile</id>
                    <goals>
                        <goal>compile</goal>
                    </goals>
                    <configuration>
                        <sourceDirs>
                            <sourceDir>${project.basedir}/src/main/kotlin</sourceDir>
                            <sourceDir>${project.basedir}/src/main/java</sourceDir>
                        </sourceDirs>
                    </configuration>
                </execution>
            </executions>
        </plugin>
        <!-- 构建包含依赖的Fat Jar -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-assembly-plugin</artifactId>
            <version>3.6.0</version>
            <configuration>
                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>
                <archive>
                    <manifest>
                        <!-- 注意：Kotlin顶层main函数编译后类名为[文件名]Kt，比如Simulator.kt对应SimulatorKt -->
                        <mainClass>com.demo.app.simulation.SimulatorKt</mainClass>
                    </manifest>
                </archive>
            </configuration>
            <executions>
                <execution>
                    <id>make-assembly</id>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

执行mvn package后，会生成simulation-1.0-jar-with-dependencies.jar，该jar包含所有依赖，可直接运行。

3. 优化Dockerfile（多阶段构建） #

采用多阶段构建，在容器内完成Maven编译，避免本地构建的环境差异：

# 构建阶段：编译代码并生成Fat Jar
FROM maven:3.8.1-openjdk-17-slim AS builder
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline  # 预下载依赖，提升构建速度
COPY src ./src
RUN mvn package -DskipTests

# 运行阶段：使用轻量的OpenJDK镜像
FROM openjdk:17-jdk-slim
WORKDIR /app
# 从构建阶段复制Fat Jar到运行镜像
COPY --from=builder /app/target/simulation-1.0-jar-with-dependencies.jar ./simulation.jar
# 直接运行jar包
ENTRYPOINT ["java", "-jar", "simulation.jar"]

4. 验证主类正确性 #

若坚持使用普通jar包，需完成以下检查：

• 用jar tf simulation-1.0.jar命令确认jar包中存在com/demo/app/simulation/Simulator.class（或SimulatorKt.class）
• 确保Kotlin标准库等依赖被复制到容器中，可在Dockerfile中添加依赖复制步骤：

# 在构建阶段复制依赖到指定目录
RUN mvn dependency:copy-dependencies -DoutputDirectory=/app/lib
# 运行阶段复制依赖和jar包
COPY --from=builder /app/lib ./lib
COPY --from=builder /app/target/simulation-1.0.jar ./

然后修改entrypoint.sh的类路径：

java -cp "lib/*:simulation-1.0.jar" com.demo.app.simulation.Simulator

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