打包含Spring依赖的JAR用于Docker时启动失败求助

你遇到的NoClassDefFoundError核心原因是：当前构建的JAR是普通JAR文件，只包含你自己的代码，没有打包Spring Boot等第三方依赖。本地运行正常是因为开发环境（IDE或Gradle的bootRun任务）会自动把所有依赖加入类路径，但Docker容器里只有单独的JAR，找不到依赖类。

1. 调整Gradle配置，构建包含所有依赖的可执行JAR #

你已经引入了Spring Boot Gradle插件，它会自动提供bootJar任务，用于生成包含所有依赖的"胖JAR"。不需要自己手动配置普通的jar任务，修改你的build.gradle.kts：

• 删除重复的tasks.jar配置块，替换为Spring Boot的bootJar配置：

// 用Spring Boot的bootJar任务生成可执行胖JAR
tasks.bootJar {
    archiveFileName.set("fraud-detection-service-$version.jar")
    manifest {
        attributes["Main-Class"] = "com.App"
    }
}

• 执行构建命令时，改用bootJar任务：

./gradlew clean bootJar

执行完成后，app/build/libs下的fraud-detection-service-1.0.jar就是包含所有依赖的可执行JAR。

2. 修改Dockerfile的启动命令 #

对于Spring Boot的胖JAR，直接用java -jar命令启动即可，不需要指定类路径和主类（胖JAR的MANIFEST文件已经包含这些信息）：

# Use a base image with a Java runtime environment
FROM adoptopenjdk:11-jre-hotspot

# Set the working directory inside the container
WORKDIR /app

# Copy the bootJar生成的胖JAR到容器
COPY app/build/libs/fraud-detection-service-1.0.jar .

# 直接用java -jar启动
CMD ["java", "-jar", "fraud-detection-service-1.0.jar"]

验证步骤 #

1. 重新构建镜像：

docker build -t fraud-detection-service .

2. 运行容器：

docker run fraud-detection-service

此时Spring应用应该能正常启动，不会再出现依赖找不到的错误。

你提到的spring-boot-maven-plugin是Maven生态的插件，对应Gradle的就是你已经引入的org.springframework.boot插件，只要正确使用bootJar任务即可生成可执行JAR，不需要额外配置其他插件。

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