Docker run执行时报错Could not find or load main class Main怎么解决

核心排查步骤 #

• 确认项目源码路径匹配
  检查执行docker build的根目录下是否直接存在Main.java文件：

  如果你的Main.java头部声明了package包路径，比如package com.xxx;，当前Dockerfile的运行逻辑不匹配：编译后的class文件需要和包结构对应，运行时要使用全限定名，例如ENTRYPOINT ["java", "com.xxx.Main"]。

• 验证镜像内部的编译产物
  直接启动镜像查看内部文件结构，执行命令：

  docker run --rm <你的镜像名> ls -la /src
  

  • 若输出中没有Main.class文件：说明构建时javac命令实际执行失败（镜像构建不会捕获RUN命令非0返回外的业务错误），可执行docker run --rm <你的镜像名> javac Main.java查看具体编译报错，一般是源码语法错误、依赖缺失导致。
  • 若输出中存在Main.class文件：尝试手动指定类路径运行，执行命令：

    docker run --rm <你的镜像名> java -cp /src Main
    

    如果运行正常，说明ENTRYPOINT未指定类路径，将Dockerfile的ENTRYPOINT修改为ENTRYPOINT ["java", "-cp", "/src", "Main"]重新构建即可。
• 排查换行符/编码异常
  如果你在Windows环境编写代码，文件换行符为CRLF可能导致OpenJDK识别异常，可以在Dockerfile的RUN ["javac", "Main.java"]步骤前新增一行：

  RUN apt-get update && apt-get install -y dos2unix && dos2unix Main.java
  

  重新构建镜像测试。

额外注意事项 #

• 不要在源码路径、类名中使用中文，避免OpenJDK8的编码兼容问题
• 若项目依赖第三方jar包，需要将所有依赖包放入镜像后，在启动命令的类路径中添加依赖，示例：ENTRYPOINT ["java", "-cp", "/src:/lib/*", "Main"]
• 构建镜像时确认上下文路径正确，不要误将上级目录或者子目录作为构建上下文。

内容的提问来源于stack exchange，提问作者minal.m