通过maven使用本地jar包

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

原创最新推荐文章于 2025-10-11 10:45:18 发布 · 1.2k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#Maven

开发工具专栏收录该内容

1 篇文章

订阅专栏

本文介绍了如何在Maven项目中使用本地jar包，包括快照版本和非快照版本的不同处理方式，以及如何修改maven-metadata.xml文件来确保正确的版本被使用。

Maven 作为当下流行的构建工具，在开发中得到了广泛的使用，开发人员可以方便的通过Maven将依赖的jar包从私服上拉取到本地。但日常开发中，经常会遇到需要使用本地jar包的情况：

jar包提供方开发还在进行中，版本还没稳定，还不具备上传至私服的条件，因此系统间的开发合作可能是通过本地打个jar包，然后将jar文件发送给依赖方，依赖方使用这个本地jar包进行开发。

下面分几种常见情景，分别介绍怎么通过maven使用本地jar包：

服务提供方P(provider)和依赖方C(consumer)两个系统都是同一个开发人员开发
这种情况是最简单的，只要在系统A上，通过maven 的 install命名，将jar包构建至本地仓库，系统B就能正常使用这个新构建的jar包了。

P和C在不同开发人员中，但是jar包是非快照版本(非SNAPSHOT)
这种情况也较简单，根据pom文件的groupId,artifactId和version在本地仓库中找到相应的目录(没有的话，就新建)，将P提供的jar包放置于此，并将jar包内的pom.xml文件拿出，重命名为何jar包一样的名字，后缀用 .pom结尾，就好了。

P和C在不同开发人员中，jar包是快照版本
对于快照版本的jar包，如果jar包的版本号，私服没有，这比较简单，和情况2一样处理就行。但是如果私服有这个版本号，情况就有点特殊了，原理分析如下：
maven对于快照版本，P每次上传jar包，maven都会为它打上一个时间戳，同时将最新的版本信息记录在 maven-metadata.xml文件中。
文件内容一般如下：
```
<?xml version="1.0" encoding="UTF-8"?>
<metadata modelVersion="1.1.0">
  <groupId>com.jd.stock.engine2</groupId>
  <artifactId>stock-engine2-test-export</artifactId>
  <version>1.1.3-SNAPSHOT</version>
  <versioning>
    <snapshot>
      <timestamp>20171228.022230</timestamp>
      <buildNumber>1</buildNumber>
    </snapshot>
    <lastUpdated>20180129020057</lastUpdated>
    <snapshotVersions>
      <snapshotVersion>
        <extension>jar</extension>
        <value>1.1.3-20171228.022230-1</value>
        <updated>20171228022230</updated>
      </snapshotVersion>
      <snapshotVersion>
        <extension>pom</extension>
        <value>1.1.3-20171228.022230-1</value>
        <updated>20171228022230</updated>
      </snapshotVersion>
    </snapshotVersions>
  </versioning>
</metadata>
```
当C重新获取依赖时，maven会首先去私服将maven-metadata.xml下载到本地，和本地的maven-metadata-local.xml文件进行比较，主要是对比更新时间(lastUpdated)的先后：(1) 如果远端下载配置文件的时间新，则去远端下载最新的jar包和pom文件至本地仓库，然后复制一份重命名为 SNAPSHOT结尾的jar包和pom文件。(2) 如果本地文件的时间新，则停止jar包的下载，以本地文件内记录的jar包信息为准，在本地仓库中进行查找。

因此这类情况，使用本地jar包方式如下：

在本地仓库响应的目录中(根据groupId等信息，前文有说明)，将maven-metadata.xml文件重命名为maven-metadata-local.xml，对文件进行修改，将lastUpdated时间后延，将jar和pom的<value>值参考本地jar包进行更改，本例中改为 1.1.3-SNAPSHOT；
清空其他所有文件，放入jar包，名字记得以SNAPSHOT结尾，不带时间戳的。
将jar包内的配置文件拿出，和jar包放在同一目录中，和jar包一样的名字， .pom结尾。

远端下下来的配置如上图，修改后的配置文件如下：

<?xml version="1.0" encoding="UTF-8"?>
<metadata modelVersion="1.1.0">
  <groupId>com.jd.stock.engine2</groupId>
  <artifactId>stock-engine2-test-export</artifactId>
  <version>1.1.3-SNAPSHOT</version>
  <versioning>
    <snapshot>
      <timestamp>20171228.022230</timestamp>
      <buildNumber>1</buildNumber>
    </snapshot>
    <lastUpdated>20180308020057</lastUpdated>
    <snapshotVersions>
      <snapshotVersion>
        <extension>jar</extension>
        <value>1.1.3-SNAPSHOT</value>
        <updated>20171228022230</updated>
      </snapshotVersion>
      <snapshotVersion>
        <extension>pom</extension>
        <value>1.1.3-SNAPSHOT</value>
        <updated>20171228022230</updated>
      </snapshotVersion>
    </snapshotVersions>
  </versioning>
</metadata>

本地仓库目录结构如下：