有时我们要用的 maven 依赖项在官方repo库中找不到，然而我们从其他渠道获得了依赖项中的所有jar文件，本文记录了如何向本地库添加jar文件。

从复杂到简单，有三种方法：

1. 使用 maven 的仓库管理器（例如Nexus）来架设一个本地仓库服务器
2. 使用指令 mvn install:install-file 将jar文件安装到本地仓库
3. 通过项目pom配置文件引入

第一种方法有利于团队开发，内容多一点，我打算单独用一篇文章记录。这里介绍其他两种方法：

使用指令 mvn install:install-file 将jar文件安装到本地仓库

语法规范：

mvn install:install-file

  -Dfile=<path-to-file>

  -DgroupId=<group-id>

  -DartifactId=<artifact-id>

  -Dversion=<version>

  -Dpackaging=<packaging>

  -DgeneratePom=true  

Where: <path-to-file>  the path to the file to load

       <group-id>      the group that the file should be registered under

       <artifact-id>   the artifact name for the file

       <version>       the version of the file

       <packaging>     the packaging of the file e.g. jar

我们以文件<not-yet-commons-ssl-0.3.17.jar>为例：

mvn install:install-file

  -Dfile=e:\not-yet-commons-ssl-0.3.17.jar

  -DgroupId=org.apache.commons

  -DartifactId=not-yet-commons-ssl

  -Dversion=0.3.17

  -Dpackaging=jar

  -DgeneratePom=true

通过项目pom配置文件引入

编辑项目pom文件，在依赖项中增加条目，并指定<scope>和<systemPath>。

还是以文件<not-yet-commons-ssl-0.3.17.jar>为例：

<dependency>

    <groupId>org.apache.commons</groupId>

    <artifactId>not-yet-commons-ssl</artifactId>

    <version>0.3.17</version>

    <scope>system</scope>

    <systemPath>e:\not-yet-commons-ssl-0.3.17.jar</systemPath>

</dependency>

等等，编译后出现一个警告：

[WARNING] 'dependencies.dependency.systemPath' for org.apache.commons:not-yet-commons-ssl:jar should use a variable instead of a hard-coded path e:\not-yet-commons-ssl-0.3.17.jar @ line 35, column 16
[WARNING]
[WARNING] It is highly recommended to fix these problems because they threaten the stability of your build.
[WARNING]
[WARNING] For this reason, future Maven versions might no longer support building such malformed projects.

原来是 maven 苦口婆心地告诉我们不要使用诸如 C:\Windows 这样的绝对路径，而应使用 ${java.home} 这样的相对路径（变量），否则降低了编译可重现性，并威胁我们以后可能不再支持这种方式。

嗯，我们可以建立一个 maven 仓库的环境变量来消除这个警告，如果你觉得有这个必要。