使用Maven构建JAX-RS应用Docker镜像时遇主类找不到错误

听起来你遇到的问题挺典型的——相同的Dockerfile配置在另一个项目能用，到这个JAX-RS项目就出问题了，还发现Entrypoint没被正确识别。咱们一步步来排查：

1. 先核对Dockerfile的Entrypoint配置 #

首先确认你的Dockerfile里Entrypoint的格式是否正确，比如可执行jar的标准启动写法应该是这样的：

ENTRYPOINT ["java", "-jar", "/app/your-app.jar"]

要注意别混用shell格式和exec格式，比如ENTRYPOINT java -jar /app/your-app.jar这种shell格式会干扰主类的查找逻辑，优先用数组形式的exec格式。

另外用docker inspect <your-image>查看Config.Entrypoint字段，对比Dockerfile里的配置，看是否完全一致。如果不一致，大概率是构建过程中Entrypoint被覆盖了——比如多阶段构建里后面的阶段有没有重新设置Entrypoint？

2. 检查Maven构建的jar包是否正确 #

JAX-RS项目打包成可执行jar时，必须确保pom.xml里的打包插件正确配置了主类：

• 若使用maven-jar-plugin，需指定主类：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <version>3.3.0</version>
    <configuration>
        <archive>
            <manifest>
                <mainClass>com.yourpackage.YourMainClass</mainClass> <!-- 替换为你的主类全路径 -->
                <addClasspath>true</addClasspath>
                <classpathPrefix>lib/</classpathPrefix>
            </manifest>
        </archive>
    </configuration>
</plugin>

• 若用maven-shade-plugin打包成包含所有依赖的fat jar，也要指定主类：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.4.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>com.yourpackage.YourMainClass</mainClass>
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

先在本地运行java -jar target/your-app.jar，如果本地也报找不到主类，那问题出在Maven打包，和Docker无关。

3. 确认Docker镜像里的jar包路径与Entrypoint匹配 #

检查Dockerfile里的COPY/ADD命令是否把jar包放到了正确位置，比如：

COPY target/your-app.jar /app/your-app.jar

目标路径/app/your-app.jar必须和Entrypoint里的路径完全一致，注意Linux镜像对大小写敏感，别在文件名或路径上出问题。

另外检查.dockerignore文件，是不是不小心把target/目录排除了？如果.dockerignore里有target/，构建时jar包根本没复制到镜像里，自然会报错。

4. 对比正常项目与当前项目的差异 #

既然另一个项目能用，把两个项目的以下内容逐行对比：

• Dockerfile：看有没有细微差异，比如文件名拼写、路径大小写
• pom.xml的打包插件配置：看当前项目是否漏了主类配置
• 项目结构：比如主类的包路径是否正确，是否在src/main/java目录下

5. 临时调试：进入容器查看实际情况 #

如果还是找不到问题，可以启动容器时覆盖Entrypoint，直接进入shell排查：

docker run -it --entrypoint /bin/bash <your-image>

进入容器后执行以下操作：

• 查看/app/目录下是否存在jar包
• 运行java -jar /app/your-app.jar查看具体报错信息
• 用jar tf /app/your-app.jar查看jar包内的文件，确认主类的.class文件是否存在，路径是否和你指定的一致

按照这些步骤排查，应该能快速定位到问题所在。

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