Docker运行Jar包时出现NoClassDefFoundError问题求助

问题原因 #

Maven的system scope依赖仅在编译和本地运行阶段生效，默认不会被打包到最终构建产物（如Jar包、Docker镜像）中，因此Docker运行时无法找到这些外部Jar的类。

解决方案 #

方案1：将外部Jar安装到本地Maven仓库 #

这是最规范的依赖管理方式，让Maven像处理普通仓库依赖一样管理外部Jar：

• 执行Maven安装命令（替换为对应Jar的路径与坐标）：

  mvn install:install-file -Dfile=./libs/suitetalk-axis-proxy-v2022_1-1.0.0.jar -DgroupId=org.suitetalk -DartifactId=suitetalk-axis-proxy-v2022_1 -Dversion=1.0.0 -Dpackaging=jar
  

• 修改pom.xml中的依赖配置，移除scope和systemPath节点：

  <dependency>
      <groupId>org.suitetalk</groupId>
      <artifactId>suitetalk-axis-proxy-v2022_1</artifactId>
      <version>1.0.0</version>
  </dependency>
  

• 重新执行mvn clean package，此时依赖会被正常打包到构建产物中。

方案2：使用maven-dependency-plugin复制System依赖到构建目录 #

若不想安装Jar到本地仓库，可通过插件强制将system依赖复制到打包目录：
在pom.xml的<build><plugins>节点中添加以下配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <executions>
        <execution>
            <id>copy-system-deps</id>
            <phase>prepare-package</phase>
            <goals>
                <goal>copy-dependencies</goal>
            </goals>
            <configuration>
                <includeScope>system</includeScope>
                <!-- Spring Boot项目使用该路径 -->
                <outputDirectory>${project.build.directory}/BOOT-INF/lib</outputDirectory>
                <!-- 普通Java项目替换为：${project.build.directory}/lib -->
            </configuration>
        </execution>
    </executions>
</plugin>

方案3：Spring Boot项目专属配置 #

如果是Spring Boot项目，可直接通过spring-boot-maven-plugin开启system依赖打包：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <includeSystemScope>true</includeSystemScope>
    </configuration>
</plugin>

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