如何强制 Maven 使用我的本地存储库而不是去远程存储库检索工件？答案

【问题标题】：How do I force Maven to use my local repository rather than going out to remote repos to retrieve artifacts?如何强制 Maven 使用我的本地存储库而不是去远程存储库检索工件？
【发布时间】：2016-02-06 12:20:22
【问题描述】：

我在 Mac Yosemite 上使用 Maven 3.3.3 和 Java 8。我有一个多模块项目。

    <modules>
            <module>first-module</module>
            <module>my-module</module>
                …
    </modules>

当我使用“mvn clean install”从上面构建我的一个子模块时，例如“my-module”，构建尝试从我在我的〜中定义的远程存储库下载子模块工件/.m2/settings.xml 文件。输出如下

[INFO]                                                                         
[INFO] ------------------------------------------------------------------------
[INFO] Building my-module 87.0.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
Downloading: https://my.remoterepository.com/nexus/content/repositories/snapshots/org/mainco/subco/first-module/87.0.0-SNAPSHOT/maven-metadata.xml
Downloading: http://download.java.net/maven/2/org/mainco/subco/first-module/87.0.0-SNAPSHOT/maven-metadata.xml
Downloaded: https://my.remoterepository.com/nexus/content/repositories/snapshots/org/mainco/subco/first-module/87.0.0-SNAPSHOT/maven-metadata.xml (788 B at 0.9 KB/sec)
Downloading: https://my.remoterepository.com/nexus/content/repositories/snapshots/org/mainco/subco/first-module/87.0.0-SNAPSHOT/first-module-87.0.0-20151104.200545-4.pom

在尝试从远程存储库下载之前，如何强制 Maven 先检查我的本地 ~/.m2/repository？下面是我在 ~/.m2/settings.xml 文件中定义远程存储库的地方……

<profile>
    <id>releases</id>
    <activation>
        <property>
            <name>!releases.off</name>
        </property>
    </activation>
    <repositories>
        <repository>
            <id>releases</id>
            <url>https://my.remoterepository.com/nexus/content/repositories/releases/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
    </repositories>
</profile>
<profile>
    <id>snapshots</id>
    <activation>
        <property>
            <name>!snapshots.off</name>
        </property>
    </activation>
    <repositories>
        <repository>
            <id>snapshots</id>
            <url>https://my.remoterepository.com/nexus/content/repositories/snapshots/</url>
            <releases>
                <enabled>false</enabled>
            </releases>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </repository>
    </repositories>
</profile>

编辑： 回答说当工件不存在时会发生下载，下面是终端输出，我在其中证明文件在我的仓库中，但 Maven 正在尝试还是下载吧……

Daves-MacBook-Pro-2:my-module davea$ ls -al ~/.m2/repository/org/mainco/subco/first-module/87.0.0-SNAPSHOT/first-module-87.0.0-SNAPSHOT.jar 
-rw-r--r--  1 davea  staff  10171 Nov  5 10:22 /Users/davea/.m2/repository/org/mainco/subco/first-module/87.0.0-SNAPSHOT/first-module-87.0.0-SNAPSHOT.jar
Daves-MacBook-Pro-2:my-module davea$ mvn clean install
[INFO] Scanning for projects...
[WARNING] 
[WARNING] Some problems were encountered while building the effective model for org.mainco.subco:my-module:jar:87.0.0-SNAPSHOT
[WARNING] 'build.plugins.plugin.(groupId:artifactId)' must be unique but found duplicate declaration of plugin org.apache.maven.plugins:maven-antrun-plugin @ org.mainco.subco:my-module:[unknown-version], /Users/davea/Documents/sb_workspace/my-module/pom.xml, line 678, column 12
[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.
[WARNING] 
[INFO]                                                                         
[INFO] ------------------------------------------------------------------------
[INFO] Building my-module 87.0.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
Downloading: https://my.remoterepository.com/nexus/content/repositories/snapshots/org/mainco/subco/first-module/87.0.0-SNAPSHOT/maven-metadata.xml
Downloading: http://download.java.net/maven/2/org/mainco/subco/first-module/87.0.0-SNAPSHOT/maven-metadata.xml
Downloaded: https://my.remoterepository.com/nexus/content/repositories/snapshots/org/mainco/subco/first-module/87.0.0-SNAPSHOT/maven-metadata.xml (788 B at 0.8 KB/sec)
Downloading: https://my.remoterepository.com/nexus/content/repositories/snapshots/org/mainco/subco/first-module/87.0.0-SNAPSHOT/first-module-87.0.0-20151106.043202-8.pom
Downloaded: https://my.remoterepository.com/nexus/content/repositories/snapshots/org/mainco/subco/first-module/87.0.0-SNAPSHOT/first-   module-87.0.0-20151106.043202-8.pom (3 KB at 21.9 KB/sec)
Downloading: http://download.java.net/maven/2/org/mainco/subco/subco/87.0.0-SNAPSHOT/maven-metadata.xml
Downloading: https://my.remoterepository.com/nexus/content/repositories/snapshots/org/mainco/subco/subco/87.0.0-SNAPSHOT/maven-metadata.xml

【问题讨论】：

Maven 确实在尝试从远程存储库下载工件之前检查您的本地存储库。在您尝试此构建之前，您确定您的本地有这些工件吗？您现在可以检查本地存储库并再次尝试另一个构建。此外，您可以在settings.xml 中指定本地存储库的位置（请参阅here）。
虽然我没有在我的 settings.xml 文件中指定我的存储库，但它是 Maven 为我设置的默认值 - ~/.m2/repository 。即使它是默认值，我也必须指定它吗？
对我来说，我的本地存储库中还有其他文件，例如 *.sha1 或 *.lastUpdate。删除除 *.jar 和 *.pom 之外的其他文件将阻止 maven 从远程存储库重新下载文件

标签： maven repository maven-3 artifacts

【解决方案1】：

依赖项有一个快照版本。对于快照，Maven 将检查本地存储库，如果在本地存储库中找到的工件太旧，它将尝试在远程存储库中查找更新的工件。这可能就是您所看到的。

请注意，此行为由存储库配置中的 updatePolicy 指令控制（快照存储库默认为 daily）。

【讨论】：

是否可以通过控制台命令参数“覆盖”它？喜欢： mvn clean install -FORCE_COMMAND
“太旧”是什么意思？它选择它可以找到的最新快照，无论是本地的还是远程的？那肯定是可怕的行为。如果我刚刚构建了一个快照，我真的想使用那个，而不是 CI 构建不久之后构建的那个。
请解释一下“太旧”是什么意思？

【解决方案2】：

使用mvn --help可以看到选项列表。

有一个类似-nsu,--no-snapshot-updates Suppress SNAPSHOT updates的选项

所以使用命令mvn install -nsu可以强制使用本地仓库编译。

【讨论】：

您也可以使用-o 进行“离线” maven 行为
-nsu 选项不会阻止 mvn 尝试远程下载工件，如果它尚未下载，而不是像在本地构建和安装工件时那样使用本地构建。 ——
我遇到了同样的问题，尚未下载工件，这为我解决了这个问题：maven.apache.org/general.html#importing-jars

【解决方案3】：

要真正强制 maven 仅使用您的本地存储库，您可以使用mvn <goals> -o 运行。 -o 告诉 maven 让你“离线”工作，它会远离网络。

【讨论】：

-o 选项不会阻止 mvn 尝试远程下载工件，如果它尚未下载，而不是像在本地构建和安装工件时那样使用本地构建。
确实如此 - 如果您没有本地副本，那么您就不走运了。这对于您之前构建的项目很有用，但最近可能有您不关心的 SNAPSHOT 更改。
或者即使您从未构建过项目，您也可以使用mvn dependency:go-offline为离线构建它做准备
如果您有一个刚刚安装的本地副本（因此它从未在远程快照存储库中部署/可用）怎么办？
啊，我刚刚创建了一个带有一系列依赖项的 pom 项目，但没有在消费项目中指定 pom，所以它正在寻找一个 jar（以及即使在离线模式下，当然也找不到它）

【解决方案4】：

按照以下步骤：

1. 确保删除位于本地的 jar 文件夹的所有内容，但要保留的 jar 除外。
  例如 .repositories、.pom、.sha1、.lastUpdated 等文件。
1. 执行mvn clean install -o命令

这将有助于使用本地存储库 jar 文件，而不是连接到任何存储库。

【讨论】：

只删除 *.repositories 和 *.sha1 文件对我有用
对我不起作用。它说“无法解决项目 XXX 的依赖关系：无法在离线模式下访问 xxxx (https:/xxxx.com/repository/maven/)，并且之前没有从它下载工件 xxxx:test:war:1.0.0。

【解决方案5】：

就我而言，我有一个和你一样的多模块项目。我必须更改我的项目所依赖的外部库之一的组 ID，如下所示。

发件人：

<dependencyManagement>
    <dependency>
        <groupId>org.thirdparty</groupId>
        <artifactId>calculation-api</artifactId>
        <version>2.0</version>
        <type>jar</type>
        <scope>provided</scope>
    </dependency>
<dependencyManagement>

收件人：

<dependencyManagement>
   <dependency>
      <groupId>org.thirdparty.module</groupId>
        <artifactId>calculation-api</artifactId>
        <version>2.0</version>
        <type>jar</type>
        <scope>provided</scope>
    </dependency>
<dependencyManagement>

注意部分。原来我忘记修改在 pom 文件中定义此依赖项的子模块的相应部分。

这让我非常抓狂，因为该模块在本地可用。

【讨论】：

谢谢这么多兄弟，把我的头发拉出来了，b/c 我正在使用父 POM groupid 信息（它也是多模块）导入到我的另一个项目中......你发帖让我意识到我的错误....非常感谢您减轻了人类同胞的痛苦

【解决方案6】：

即使在考虑上述所有答案时，您仍然可能会遇到会终止您的 maven 离线构建并出现错误的问题。特别是，您可能会遇到如下警告：

[WARNING] The POM for org.apache.maven.plugins:maven-resources-plugin:jar:2.6 is missing, no dependency information available

警告之后会立即出现更多错误，maven 将终止。

对我们来说，使用按照上述提示创建的 maven 离线缓存进行离线构建的最安全方法是使用以下 maven 离线参数：

mvn -o -llr -Dmaven.repo.local=<path_to_your_offline_cache> ...

特别是，选项 -llr 使您不必按照答案 #4 中的建议调整本地缓存。

还要注意 settings.xml 中的参数指向本地 Maven 存储库的正确文件夹。

【讨论】：

我的 settings.xml 中没有 localRepository 属性....谢谢兄弟
@ThoR 您的回答很有帮助。请记住，并非每个人的配置都与您相同。如您所示设置我的本地存储库会破坏 maven，哈哈。而不是你的最后一个代码 sn-p，只需说“将 settings.xml 文件中的指向正确的文件夹”。
@cb4 你是对的。代码 sn-p 是特定的，因为它专注于用户特定的 settings.xml 和存储库文件夹。谢谢你的提示。已调整说明。

【解决方案7】：

Maven 总是首先检查你的本地存储库，但是，你的依赖项需要安装在你的 repo 中，maven 才能找到它。

先在你的依赖模块中运行mvn install，然后再构建你的依赖模块。

【讨论】：

我已经编辑了我的问题以表明该工件在存储库中（请注意我运行的“ls -al”命令。但 Maven 无论如何都在尝试下载它。还有其他想法吗？
@Oliver：您错过了这样一个事实，即对于本地存储库中的工件，如果工件是太旧的快照，Maven 仍可能会查询远程存储库。

【解决方案8】：

-o 选项对我不起作用，因为工件仍在开发中，尚未上传，maven (3.5.x) 仍然尝试从远程存储库下载它，因为这是第一次，根据错误我明白了。

但是这为我解决了这个问题：https://maven.apache.org/general.html#importing-jars

此手动安装后，也无需使用离线选项。

更新

我刚刚重建了依赖项，我不得不重新导入它：常规的mvn clean install 对我来说不够用

【讨论】：

【解决方案9】：

我遇到了完全相同的问题。运行 mvn clean install 而不是 mvn clean compile 解决了它。仅在使用 multi-maven-project 时会出现差异，因为项目依赖项是通过 install 上传到本地存储库的。

【讨论】：

【解决方案10】：

使用

【讨论】：

您好，感谢您对 StackOverflow 的贡献。请考虑在发布之前为您的答案添加更多详细信息。另外，请记住使用适当的样式。您的回答似乎也不完整。请对其进行编辑，否则您可能会遭到否决和强制删除。

【解决方案11】：

只是为了给我 2 美分。对我来说，只需要在 ~/.m2/repository 目录中找到 jar 并使用它的版本。所以，使用后

cd local-dependency/
mvn install

local-dependency jar 将在 .m2/repository/com/your-organization/local-dependency/ 中

~$ tree ~/.m2/repository/com/your-organization/local-dependency/
/home/felipe/.m2/repository/com/your-organization/local-dependency/
├── 0.1-SNAPSHOT
│   ├── maven-metadata-local.xml
│   ├── _remote.repositories
│   ├── local-dependency-0.1-SNAPSHOT.jar
│   ├── local-dependency-0.1-SNAPSHOT.pom
│   └── resolver-status.properties
└── maven-metadata-local.xml

然后将其用作本地依赖项

<dependency>
   <groupId>com.your-organization</groupId>
   <artifactId>local-dependency</artifactId>
   <version>0.1-SNAPSHOT</version>
</dependency>

【讨论】：