如何通过Maven构建外部Jar包使其在Kubernetes中正常运行

原因分析 #

使用system scope的依赖不会被Maven自动打包到构建产物中，本地能正常运行是因为本地存在${basedir}/lib/jumper.jar路径，但Kubernetes容器内没有这个文件，导致类加载失败。

可行解决方案 #

1. 将Jar包安装到本地Maven仓库（团队内部场景推荐） #

在本地执行以下命令，把外部Jar包安装到本地Maven仓库，之后修改POM移除system和systemPath配置：

mvn install:install-file -Dfile=lib/jumper.jar -DgroupId=com.abc -DartifactId=jump -Dversion=1.0 -Dpackaging=jar

修改后的POM依赖：

<dependency>
  <groupId>com.abc</groupId>
  <artifactId>jump</artifactId>
  <version>1.0</version>
</dependency>

修改后Maven会自动从本地仓库拉取依赖并打包到构建产物中，Kubernetes容器内即可正常加载。

2. 用Maven插件强制打包外部Jar包 #

如果无法安装到本地仓库，可通过maven-dependency-plugin复制外部Jar到构建目录，再用maven-jar-plugin配置类路径：

<build>
  <plugins>
    <!-- 复制外部Jar到target/lib目录 -->
    <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>
            <outputDirectory>${project.build.directory}/lib</outputDirectory>
          </configuration>
        </execution>
      </executions>
    </plugin>
    <!-- 配置Jar包类路径，包含外部Jar -->
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-jar-plugin</artifactId>
      <configuration>
        <archive>
          <manifest>
            <addClasspath>true</addClasspath>
            <classpathPrefix>lib/</classpathPrefix>
            <mainClass>你的主类全路径</mainClass>
          </manifest>
        </archive>
      </configuration>
    </plugin>
  </plugins>
</build>

构建后外部Jar会被复制到target/lib，打包Docker镜像时将该目录包含进去即可。

3. 在Docker镜像中直接添加外部Jar包 #

如果使用Docker构建镜像，可在Dockerfile中复制本地Jar到容器内指定路径，启动时手动指定类路径：

FROM openjdk:17-jdk-slim
COPY target/your-app.jar /app/your-app.jar
COPY lib/jumper.jar /app/lib/jumper.jar
# 启动命令指定完整类路径
CMD ["java", "-cp", "/app/your-app.jar:/app/lib/jumper.jar", "你的主类全路径"]

这种方式无需修改POM，直接在容器内提供外部Jar的路径，确保JVM能加载到。

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