Fat Jar在宿主机正常运行，Docker容器中启动失败求助

可能的原因 #

1. 自定义库Jar结构错误：你的自定义库mylibrary.jar中错误包含了src目录，导致类文件路径为externaljarname/src/MyOtherClass.class，而非Java规范要求的包结构路径（如externaljarname/MyOtherClass.class）。本地环境可能因额外类路径（如本地源码、残留依赖）自动补全了错误，但Docker容器仅依赖Fat Jar，因此触发NoClassDefFoundError。
2. Docker复制Jar文件错误：COPY ./target/*.jar ./app.jar可能复制了Shade插件生成的原始Jar（未包含依赖类），而非真正的Fat Jar，导致容器运行时缺失依赖。
3. 自定义库安装参数不完整：执行mvn install:install-file时未指定groupId、artifactId等核心参数，导致Maven对依赖的处理异常，Shade插件未正确合并自定义库的类。

解决步骤 #

1. 修复自定义库的Jar结构 #

• 检查自定义库的Jar内容：

  jar tf mylibrary.jar
  

  若输出中存在src/开头的类路径，说明打包错误。
• 重新正确打包自定义库：
  • 若自定义库是Maven项目，执行：

    mvn clean package
    

  • 若为非Maven项目，手动编译打包：

    # 编译源码到classes目录，生成规范包结构
    javac -d classes src/externaljarname/MyOtherClass.java
    # 打包classes目录下的内容
    jar cvf mylibrary.jar -C classes .
    

2. 重新安装自定义库到Maven仓库 #

执行完整的安装命令，确保参数齐全：

mvn clean org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file \
  -Dfile="mylibrary.jar" \
  -DgroupId=你的自定义组名 \
  -DartifactId=mylibrary \
  -Dversion=1.0.0 \
  -Dpackaging=jar

3. 确保Shade插件生成正确的Fat Jar #

• （可选）修改Shade插件配置，指定Fat Jar输出文件名，避免与原始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>
                              mypackage.MyMainClass
                          </mainClass> 
                      </transformer> 
                  </transformers> 
                  <createDependencyReducedPom>false</createDependencyReducedPom>
                  <!-- 指定Fat Jar输出文件名 -->
                  <outputFile>${project.build.directory}/${project.artifactId}-fat.jar</outputFile>
              </configuration> 
          </execution> 
      </executions> 
  </plugin>
  

• 重新打包主项目：

  mvn clean package
  

• 解压生成的Fat Jar，确认其中包含externaljarname/MyOtherClass.class（无src前缀）。

4. 修正Dockerfile的Jar复制逻辑 #

明确复制正确的Fat Jar，避免复制错误文件：

FROM openjdk:11-jre-slim
MAINTAINER "Docker App <docker@app.com>"
WORKDIR /app

# 替换为你的Fat Jar实际文件名
COPY ./target/appname-fat.jar ./app.jar
ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", "/app/app.jar"]

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