构建Docker镜像遇ClassNotFoundException：主类加载失败求助

问题根源 #

你之前的写法完全错误：CMD java src.main.java.com.yuanhe.demo2.Demo2Application 混淆了源码路径和类路径。Java虚拟机运行的是编译后的.class字节码文件，而非.java源码；且运行时需要指定全限定类名（用点分隔，如com.yuanhe.demo2.Demo2Application），同时确保该类的字节码在类路径范围内。

正确解决方案（分两种场景） #

场景1：使用可执行Jar包（推荐，尤其Spring Boot项目） #

绝大多数Java Web项目（比如你的Spring Boot应用）会通过Maven/Gradle打包成包含所有依赖的可执行Jar包，步骤如下：

1. 先在本地打包项目：

   • Maven：执行 mvn clean package
   • Gradle：执行 gradle clean build
     打包后会在target（Maven）或build/libs（Gradle）目录下生成Jar文件。

2. 编写Dockerfile：

   # 选择合适的OpenJDK基础镜像
   FROM openjdk:17-jdk-slim
   
   # 将本地打包好的Jar复制到镜像内，并重命名为app.jar（方便后续使用）
   COPY target/demo2-0.0.1-SNAPSHOT.jar app.jar
   
   # 运行Jar包（Spring Boot的可执行Jar内置了主类配置，无需额外指定）
   CMD ["java", "-jar", "app.jar"]
   

   注意：替换target/demo2-0.0.1-SNAPSHOT.jar为你实际的Jar包路径和名称。

场景2：直接运行编译后的Class文件 #

如果不打包成Jar，需要确保编译后的Class文件路径正确，并指定类路径：

1. 先编译项目，确保target/classes目录下存在com/yuanhe/demo2/Demo2Application.class文件。

2. 编写Dockerfile：

   FROM openjdk:17-jdk-slim
   
   # 将编译后的Class文件目录复制到镜像内
   COPY target/classes /app/classes
   
   # 指定类路径为/app/classes，然后运行主类
   CMD ["java", "-cp", "/app/classes", "com.yuanhe.demo2.Demo2Application"]
   

关键检查点 #

• 确认编译后的.class文件存在：比如检查本地target/classes/com/yuanhe/demo2/Demo2Application.class是否生成。
• 如果使用Jar包，可通过jar tf your-app.jar查看Jar内是否包含com/yuanhe/demo2/Demo2Application.class，同时检查Jar的META-INF/MANIFEST.MF文件是否包含Main-Class（普通Java应用）或Start-Class（Spring Boot应用）配置。

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