Maven dependency中本地jar包依赖的问题

最新推荐文章于 2025-10-11 10:45:18 发布

转载最新推荐文章于 2025-10-11 10:45:18 发布 · 1.4w 阅读

文章标签：

#maven 本地jar依赖

maven 专栏收录该内容

4 篇文章

订阅专栏

本文介绍如何使用Maven将本地系统依赖的jar包整合到最终的可执行jar中，通过配置systemScope和使用maven-install-plugin插件，实现外部jar包的安装与打包，确保项目在任何环境下都能独立运行。

在maven项目中，我们的项目依赖一般取自local的repository或者远程的repository，比如下面这个配置：

<dependency>
   <groupId>commons-cli</groupId>
   <artifactId>commons-cli</artifactId>
   <version>1.2</version>
</dependency>

一般而言，maven会先去本地的repository寻找，如果找不到，就会依据<repository>的定义，去远程的repository去找依赖。

不过有时候，我们依赖的jar并不在任何repository中，可能就是从同事那里拷贝来的一个孤独的jar文件。怎么办？

Maven有办法处理这种情况，它支持systemscope的定义方式，可以加载本地任意路径下的jar包，定义如下：

<dependency>
   <groupId> commons-cli </groupId>
   <artifactId> commons-cli </artifactId>
   <version>1.0.0</version>
   <scope>system</scope>
   <systemPath>${basedir}/libs/commons-cli.jar</systemPath>
</dependency>

这样，把想要加载的jar包：commons-cli.jar放到工程的libs/目录下，在java code中就可以引用这个jar包中的class了。

往往在项目开发中，我们需要把整个项目加上依赖，打成一个jar包，这样放到任何地方都可以独立运行，不依赖于任何其他jar包，非常方便。

这个时候，我们会发现，对于<scope>system</scope>，maven不会把这个jar包的内容打包到最后的jar-with-dependencies.jar中，怎么办？

后来在网上找到一个有趣的办法：既然maven可以把repository中的依赖打到最后的jar包中，那么把这个外部的jar包放到repository中，也就可以让maven把这个外部的jar包打到最后的jar包中。

Maven支持安装jar包到本地的repository，所以这个方法是可行的，具体pom配置如下：

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-install-plugin</artifactId>
<executions>
<execution>
<id>install-external</id>
<phase>clean</phase>
<configuration>
<file>${basedir}/libs/commons-cli.jar</file>
<repositoryLayout>default</repositoryLayout>
<groupId>commons-cli</groupId>
<artifactId>commons-cli</artifactId>
<version>1.0.0</version>
<packaging>jar</packaging>
<generatePom>true</generatePom>
</configuration>
<goals>
<goal>install-file</goal>
</goals>
</execution>
</executions>
</plugin>