我如何强制 Maven 使用我的本地存储库而不是去远程存储库检索工件?
How do I force Maven to use my local repository rather than going out to remote repos to retrieve artifacts?
我在 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 总是首先检查您的本地存储库,但是,您的依赖项需要安装在您的存储库中以便 Maven 找到它。
运行 mvn install
先在你的依赖模块中,然后构建你的依赖模块。
依赖项有一个快照版本。对于快照,Maven 将检查本地存储库,如果在本地存储库中找到的工件太旧,它将尝试在远程存储库中查找更新的工件。这可能就是您所看到的。
请注意,此行为由存储库配置中的 updatePolicy
指令控制(快照存储库默认为 daily
)。
就我而言,我和您一样有一个多模块项目。我不得不更改我的项目所依赖的外部库之一的组 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 文件中定义此依赖项的子模块的相应部分。
这让我非常抓狂,因为该模块在本地可用。
使用mvn --help
可以看到选项列表。
有个选项像-nsu,--no-snapshot-updates Suppress SNAPSHOT updates
所以使用命令mvn install -nsu
可以强制使用本地仓库编译。
要真正强制 Maven 仅 使用您的本地存储库,您可以运行 和mvn <goals> -o
。 -o
告诉 maven 让你工作 "offline",它将远离网络。
-o 选项对我不起作用,因为工件仍在开发中,尚未上传,maven (3.5.x) 仍尝试从远程存储库下载它,因为它是第一个时间,根据我得到的错误。
但是这对我来说已经解决了:https://maven.apache.org/general.html#importing-jars
此手动安装后,也无需使用离线选项。
更新
我刚刚重建了依赖关系,我不得不重新导入它:常规 mvn clean install
对我来说不够
按照以下步骤操作:
- 确保删除本地 jar 文件夹的所有内容,除了要保留的 jar。
例如 .repositories、.pom、.sha1、.lastUpdated 等文件
- 执行
mvn clean install -o
命令
这将有助于使用本地存储库 jar 文件,而不是连接到任何存储库。
我遇到了完全相同的问题。 运行 mvn clean install
而不是 mvn clean compile
解决了它。
只有在使用 multi-maven-project 时才会出现差异,因为项目依赖项是通过使用 install.
上传到本地存储库的
即使考虑了以上所有答案,您仍然可能 运行 遇到会因错误而终止您的 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 存储库的正确文件夹。
使用
只是为了给我 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>
我在 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 总是首先检查您的本地存储库,但是,您的依赖项需要安装在您的存储库中以便 Maven 找到它。
运行 mvn install
先在你的依赖模块中,然后构建你的依赖模块。
依赖项有一个快照版本。对于快照,Maven 将检查本地存储库,如果在本地存储库中找到的工件太旧,它将尝试在远程存储库中查找更新的工件。这可能就是您所看到的。
请注意,此行为由存储库配置中的 updatePolicy
指令控制(快照存储库默认为 daily
)。
就我而言,我和您一样有一个多模块项目。我不得不更改我的项目所依赖的外部库之一的组 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>
注意
这让我非常抓狂,因为该模块在本地可用。
使用mvn --help
可以看到选项列表。
有个选项像-nsu,--no-snapshot-updates Suppress SNAPSHOT updates
所以使用命令mvn install -nsu
可以强制使用本地仓库编译。
要真正强制 Maven 仅 使用您的本地存储库,您可以运行 和mvn <goals> -o
。 -o
告诉 maven 让你工作 "offline",它将远离网络。
-o 选项对我不起作用,因为工件仍在开发中,尚未上传,maven (3.5.x) 仍尝试从远程存储库下载它,因为它是第一个时间,根据我得到的错误。
但是这对我来说已经解决了:https://maven.apache.org/general.html#importing-jars
此手动安装后,也无需使用离线选项。
更新
我刚刚重建了依赖关系,我不得不重新导入它:常规 mvn clean install
对我来说不够
按照以下步骤操作:
- 确保删除本地 jar 文件夹的所有内容,除了要保留的 jar。
例如 .repositories、.pom、.sha1、.lastUpdated 等文件
- 确保删除本地 jar 文件夹的所有内容,除了要保留的 jar。
- 执行
mvn clean install -o
命令
- 执行
这将有助于使用本地存储库 jar 文件,而不是连接到任何存储库。
我遇到了完全相同的问题。 运行 mvn clean install
而不是 mvn clean compile
解决了它。
只有在使用 multi-maven-project 时才会出现差异,因为项目依赖项是通过使用 install.
即使考虑了以上所有答案,您仍然可能 运行 遇到会因错误而终止您的 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 中的参数
使用 只是为了给我 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>