MAVEN 远程仓库配置说明

已于 2022-12-16 16:18:17 修改
阅读量877 收藏 3
点赞数 2
分类专栏： maven 文章标签： maven
于 2022-12-16 16:01:52 首次发布
原文链接：http://www.yaotu.net/biancheng/16963.htm
版权

MAVEN 远程仓库配置说明

文章目录

MAVEN 仓库分类以及优先级1

MAVEN 仓库分类

maven的仓库主要是用于存储及管理项目中所依赖的组件。可分为本地仓库和远程仓库，远程仓库有可以细分为中央仓库、私有仓库，中央仓库主要是由maven的开发团队负责开发管理的一些公共组件的公用的仓库；私有仓库主要是指个人通过一些第三方平台搭建的自己的专属仓库；私有仓库又可以根据配置的位置不同可分为全局profile仓库、项目profile仓库、项目仓库、镜像仓库。

在这里插入图片描述

  1. 本地仓库：settings.xml文件的 localRepository 标签来指定本地仓库的目录。
<localRepository>D:\Work\Maven\repositoryNexus</localRepository>
  1. 项目profile仓库：通过项目的 pom.xml 中的 profiles.profile.repositories.repository 配置，仅对该maven的项目都生效。
<project>
...
<profiles>
	<profile>
		<id>dev</id>
		<repositories>
			<repository>
				<id>nexus-repo</id>
				<name>nexus-repo</name>
				<url>http://127.0.0.1:8081/repository/maven-public/</url>
				<layout>default</layout>
				<releases>
					<enabled>true</enabled>
				</releases>
				<snapshots>
					<enabled>true</enabled>
				</snapshots>
			</repository>
		</repositories>
		<!--激活profile-->
		<activation>
			<activeByDefault>true</activeByDefault>
		</activation>
	</profile>
</profiles>
...
</project>
  1. 项目仓库：通过项目的 pom.xml 中的 repositories.repository 配置，仅对该maven的项目都生效。
<project>
...
<repositories>
	<repository>
		<id>snapshots</id>
		<name>snapshots-repo</name>
		<url>http://127.0.0.1:8081/repository/maven-snapshots/</url>
		<layout>default</layout>
		<snapshots>
			<enabled>true</enabled>
			<updatePolicy>always</updatePolicy>
			<checksumPolicy>warn</checksumPolicy>
		</snapshots>
		<releases>
			<enabled>true</enabled>
			<updatePolicy>always</updatePolicy>
			<checksumPolicy>warn</checksumPolicy>
		</releases>
	</repository>
</repositories>
...
</project>
  1. 全局profile仓库：通过 settings.xml 中的 profiles.profile.repositories.repository 配置，对所有使用该maven的项目都生效。
<settings>
...
<profiles>
	<profile>
		<id>dev</id>
		<repositories>
			<repository>
				<id>nexus-repo</id>
				<name>nexus-repo</name>
				<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
				<layout>default</layout>
				<releases>
					<enabled>true</enabled>
				</releases>
				<snapshots>
					<enabled>true</enabled>
				</snapshots>
			</repository>
		</repositories>
	</profile>
</profiles>
<!--激活profile-->
<activeProfiles>
	<activeProfile>dev</activeProfile>
</activeProfiles>
...
</settings>
  1. 镜像仓库：通过 settings.xml 中的 mirrors.mirror 配置。主要提供一个方便切换远程仓库地址的途径。
<settings>
...
<mirrors>
	<mirror>
		<id>nexus-aliyun</id>
	　　<name>Nexus aliyun</name>
	　　<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
	　　<mirrorOf>central</mirrorOf>
	</mirror>
</mirrors>
...
</settings>
  1. 中央仓库：是maven默认的远程仓库，在maven的lib安装目录中有一个maven-model-builder-xxx.jar，在这个jar包中有个org/apache/maven/model/pom-4.0.0.xml文件，在这个pom文件中就配置了中央仓库，默认的中央仓库的id为central。

MAVEN 仓库相关配置优先级

maven构建的时候，先从本地仓库去寻找组件，本地仓库找不到再去远程仓库中寻找，所以本地仓库的优先级要高于远程仓库。

要点：
（1）当配置多个repository时，无论是配置在settings.xml文件还是pom.xml文件中，依次从这些仓库中查找，如果第一个仓库能找到，就用第一个仓库，如果找不到，就依次往下找。
（2）当同时配置了多个repository和mirror时，如果当中某个repository的id与mirror的mirrorOf的内容相同时，则表示这个仓库被镜像了，将不在从该repository对应的url地址下载组件，而是直接从mirror中的url地址去下载组件。如果repository中的id都没有与mirror的mirrorOf的内容相同时，则依次从这些repository和mirror对应的url地址去查找，直到找到为止。
（3）当mirrorOf的内容为*时，则表示该镜像可以是所有仓库的镜像，无论配置了多少个仓库，都不会从这些仓库对应的url地址去下载组件，只会从这个mirror中的url地址去下载组件。

maven settings.xml 远程仓库配置

配置远程仓库时需要清楚 settings.xml 一下配置节点的功能，清楚这些节点配置的 url 的优先级，是进行覆盖还是遍历，避免出现配置失效的情况，就算出现失效的情况也能找到失效的原因。

proxy、server、repository、mirror 区别 2

maven的settings.xml文件里面有proxy、server、repository、mirror的配置，在配置仓库地址的时候容易混淆

proxy 是服务器不能直接访问外网时需要设置的代理服务，不常用

server 是服务器要打包上传到私服时，设置私服的鉴权信息

repository 是服务器下载jar包的仓库地址

mirror 是用于替代仓库地址的镜像地址

mirror 中的 mirrorOf 功能：3

可以理解为，mirrorof就是镜像规则。这个规则，将镜像mirror（settings.xml的设置）和远程仓库repository（pom.xml的repository设置）关联起来。哪个远程仓库被哪个镜像所替代。

mirrorOf 的值是 repository 的 id 或多个 id 的集合(多个以逗号隔开，还可以使用!)4

<mirrorOf>*<mirrorOf><!-- :匹配所有远程仓库。 -->
    
<mirrorOf>external:*<mirrorOf><!-- :匹配所有远程仓库，使用localhost的除外，使用file://协议的除外。也就是说，匹配所有不在本机上的远程仓库。 -->
    
<mirrorOf>repo1,repo2<mirrorOf><!-- :匹配仓库repo1h和repo2，使用逗号分隔多个远程仓库。 -->
    
<mirrorOf>*,!repo1<mirrorOf><!-- :匹配所有远程仓库，repo1除外，使用感叹号将仓库从匹配中排除。 -->

注意：2

1、在mirrorOf 与 repository 的 Id 相同的时候优先是使用 mirror 的地址

2、mirrorOf 等于*的时候覆盖所有 repository 配置

3、存在多个 mirror 配置的时候 mirrorOf 等于 * 放到最后

setting.xml 中 mirror 与 repository 配置优先级 4

mirror 优先级 高于 repository 配置。 特别是 mirror 配置了 mirrorOf等于 * ， 那么 repository 配置就失效了。

maven获取真正起作用的repository集合流程：
首先会获取 repository 集合，然后在settings.xml里找mirrors元素， 如果repository的id和mirror的mirrorOf的值相同，则该mirror替代该repository， 如果该repository找不到对应的mirror， 则使用其本身，依此可以得到最终起作用的repository集合， repositories中默认包含了中央仓库central，当然也可以重新它的url； 可以理解mirror是复写了对应id的repository

即 mirror 不是配置 mirrorOf等于 * ， 那么最终的 获取远程 jar 就会 结合 mirror 与 repository 配置一起 获取都所有的远程maven 仓库。 然后 一个仓库一个仓库取找jar 。

activeProfile 与 profile 配置的关联

profile 中环境配置，可以根据不同环境配置设置不同配置，然后根据 activeProfile 配置对应的 profile 的 id 进行激活对应的配置

总结

  1. 自己公司有自己的远程仓库的 最好完善 repository 远程仓库配置，而不是直接配置代理；
  2. 需要打包上传文件则需要根据 repository 远程仓库的 id 配置对应的用户密码；
  3. mirror 是用于替代 repository 配置的远程仓库地址，这里特别注意 mirrorOf 的用法，尽量避免使用*。

配置示例：

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
	<localRepository>本机mavne仓库地址</localRepository>
	<offline>false</offline>
	<pluginGroups>
		<pluginGroup>org.sonarsource.scanner.maven</pluginGroup>
	</pluginGroups>
	<proxies>
	</proxies>
	<servers>
		<!-- 用户验证，用于上传对应远程仓库 -->
		<server>
			<!-- 下方repository节点id -->
			<id>远程仓库2的id</id>
			<username>对应用户</username>
			<password>对应用户密码</password>
		</server>
		<server>
			<id>远程仓库3的id</id>
			<username>对应用户</username>
			<password>对应用户密码</password>
		</server>
	</servers>
	<mirrors>
		<!-- 远程仓库对应的镜像地址，优先从镜像地址获取资源。mirrorOf 包含的对应的远程仓库配置 id 都通过该镜像进行获取资源。mirrorOf 慎重配置 *，配置*则 repositories 失效 -->
		<mirror>
			<id>自定义镜像仓库id</id>
			<name>镜像仓库名称自定义</name>
			<mirrorOf>远程仓库集合或*</mirrorOf>
			<url>镜像地址</url>
		</mirror>
	</mirrors>
	<profiles>
		<profile>
			<id>dev</id>
			<repositories>
				<!-- 远程仓库地址，可以多个 -->
				<repository>
					<!-- (注意id不可与其他仓库id重复) -->
					<id>远程仓库1的id</id>
					<name>远程仓库名称自定义</name>
					<url>仓库地址</url>
					<releases>
						<enabled>true</enabled>
					</releases>
					<!-- 缺少这个会无法下载快照版本的jar -->
					<snapshots>
						<enabled>true</enabled>
					</snapshots>
				</repository>
				<repository>
					<!-- (注意id不可与其他仓库id重复) -->
					<id>远程仓库2的id</id>
					<name>远程仓库名称自定义</name>
					<url>仓库地址</url>
				</repository>
				<repository>
					<!-- (注意id不可与其他仓库id重复) -->
					<id>远程仓库3的id</id>
					<name>远程仓库名称自定义</name>
					<url>仓库地址</url>
				</repository>
			</repositories>
		</profile>
	</profiles>
	<!-- 激活对应的 profile 节点配置，可以激活多个 -->
	<activeProfiles>
		<activeProfile>dev</activeProfile>
	</activeProfiles>
</settings>

pom.xml 远程仓库相关配置

distributionManagement 中配置仓库地址5

部署构件至远程仓库
我们自己搭建远程仓库的目的就是为了可以方便部署我们自己项目的构件以及一些无法从外部仓库直接获取的构件。这样才能在开发时，供其他对团队成员使用。

Maven除了能对项目进行编译、测试、打包之外，还能将项目生成的构件部署到远程仓库中。首先，需要编辑项目的pom.xml文件。配置distributionManagement元素，代码如下：

注意：下方 id 要和 maven 的 setting.xml 文件中的 server 的id保持一致

<distributionManagement>
        <repository>
            <id>releases</id>
            <name>public</name>
            <url>稳定版仓库地址</url>
        </repository>
        <snapshotRepository>
            <id>snapshots</id>
            <name>Snapshots</name>
            <url>快照文件仓库地址</url>
        </snapshotRepository>
</distributionManagement>

setting.xml

<settings>
...
	<servers>
		<server>
			<id>releases</id>
			<username>用户</username>
			<password>密码</password>
		</server>
		<server>
			<id>snapshots</id>
			<username>用户</username>
			<password>密码</password>
		</server>
	</servers>
...
</settings>

repositories 配置仓库地址5

<!-- 配置远程仓库 -->
    <repositories>
        <repository>
            <id>jboss</id>
            <name>JBoss Repository</name>
            <url>http://repository.jboss.com/maven2/</url>
            <releases>
                <enabled>true</enabled>
                <updatePolicy>daily</updatePolicy>
            </releases>
            <snapshots>
                <enabled>false</enabled>
                <checksumPolicy>warn</checksumPolicy>
            </snapshots>
            <layout>default</layout>
        </repository>
    </repositories>

**repository:**在repositories元素下，可以使用repository子元素声明一个或者多个远程仓库。

**id：**仓库声明的唯一id，尤其需要注意的是，Maven自带的中央仓库使用的id为central，如果其他仓库声明也使用该id，就会覆盖中央仓库的配置。

**name：**仓库的名称，让我们直观方便的知道仓库是哪个，暂时没发现其他太大的含义。

**url：**指向了仓库的地址，一般来说，该地址都基于http协议，Maven用户都可以在浏览器中打开仓库地址浏览构件。

releases和snapshots：用来控制Maven对于发布版构件和快照版构件的下载权限。需要注意的是enabled子元素，该例中releases的enabled值为true，表示开启JBoss仓库的发布版本下载支持，而snapshots的enabled值为false，表示关闭JBoss仓库的快照版本的下载支持。根据该配置，Maven只会从JBoss仓库下载发布版的构件，而不会下载快照版的构件。

**layout：**元素值default表示仓库的布局是Maven2及Maven3的默认布局，而不是Maven1的布局。基本不会用到Maven1的布局。
其他：对于releases和snapshots来说，除了enabled，它们还包含另外两个子元素updatePolicy和checksumPolicy。

1：元素updatePolicy用来配置Maven从远处仓库检查更新的频率，默认值是daily，表示Maven每天检查一次。其他可用的值包括：never-从不检查更新；always-每次构建都检查更新；interval：X-每隔X分钟检查一次更新（X为任意整数）。

2：元素checksumPolicy用来配置Maven检查校验和文件的策略。当构建被部署到Maven仓库中时，会同时部署对应的检验和文件。在下载构件的时候，Maven会验证校验和文件，如果校验和验证失败，当checksumPolicy的值为默认的warn时，Maven会在执行构建时输出警告信息，其他可用的值包括：fail-Maven遇到校验和错误就让构建失败；ignore-使Maven完全忽略校验和错误。

profiles.profile.repositories.repository 配置

setting.xml 和 pom.xml 的完整的节点说明可以参考 6

总结

远程仓库配置主要4块，pom.xml中2种，settings.xml 中2种，其中 repository 配置是取pom.xml和settings.xml 的 repository 并集，在这些仓库中寻找资源，找到了就不继续查找其他仓库。

setting.xml 中的 mirror 的仓库地址通过 mirrorOf 配置被替代的 repository 的 id 集合，导致对应的 repository 配置的仓库地址失效，后面访问的都是是对应的 mirror 地址；

参考：

  1. Maven仓库的分类及优先级 (yaotu.net) ↩︎

  2. 【maven】maven settings.xml 中 mirror 和 repository 的区别_engineer_hzl的博客-CSDN博客_setting.xml和repository的区别 ↩︎ ↩︎

  3. maven 配置mirror 与repository 以及它们之间的配置优先级 ↩︎

  4. maven的setting配置文件中mirror和repository的区别 - 简书 (jianshu.com) ↩︎ ↩︎

  5. pom配置 仓库信息 - 日行一善g - 博客园 (cnblogs.com) ↩︎ ↩︎

  6. Maven学习—setting.xml & pom.xml 配置文件详解_飞鸽FlyGo的博客-CSDN博客_pom.xml settings.xml ↩︎

h_l_614
关注
  • 2
    点赞
  • 踩
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Maven之远程仓库的配置详解
09-07
主要介绍了Maven之远程仓库的配置详解，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
maven配置本地仓库和远程仓库
11-28
设置Maven的本地仓库与远程仓库，还是挺简单的，在maven的conf中的setting.xml中配置
windows10下设置Maven的本地仓库和阿里云的远程中央仓库
Jason的学习笔记
03-22 1041
感谢原文作者：测试zhang 原文链接：https://www.jianshu.com/p/1782feee6eff 1.设置Maven的本地仓库 Maven的本地仓库默认地址位于 C:\Users\用户名.m2 目录下，仓库中的jar包体积会随着项目的迭代而变得很大，所以我把仓库的地址切换到了D盘，具体步骤如下： （1）下载maven 下载地址：http://maven.apache.org...
Maven远程仓库的配置和部署，程序员的中年危机
code8889的博客
03-28 932
还有更多的Redis、MySQL、JVM、Kafka、微服务、Spring全家桶等学习笔记这里就不一一列举出来JAVA架构专题的面试点+解析+我的一些学习的书籍资料**[外链图片转存中…(img-D2Ro7vEM-1711571167823)]还有更多的Redis、MySQL、JVM、Kafka、微服务、Spring全家桶等学习笔记这里就不一一列举出来。
【Maven】—— Maven 简介及仓库配置
秋玄的博客
11-11 1061
Maven 基础介绍及仓库配置
Maven配置远程仓库
热门推荐
开源世界
04-13 2万+
方法一：修改maven配置文件 我使用的是IDEA编译器，使用maven自己的库下载文件非常的慢。阿里代理了很多公共的maven仓库，使用maven.aliyun.com中的仓库地址作为下载源，速度更快更稳定。 打开你的maven的安装地址，找到conf文件夹下面的settings.xml文件并打开，在<mirrors></mirrors>标签中间插入镜像的配置参数。 ...
MAVEN设置远程仓库
weixin_42975731的博客
08-28 4174
注意：在settings.xml中添加profiles后，mirrors可以省略。第二种方式：配置maven的settings.xml (作用于全局)第一种方式：配置pom.xml (只作用于当前项目)
maven下载安装配置远程本地仓库
weixin_55897008的博客
01-25 2345
maven下载安装配置远程本地仓库
Maven配置仓库
久绊A的博客
06-15 9295
本地仓库：就像你自己的书库。当你使用 Maven 下载依赖项时，它们会被保存在你电脑上的一个特定目录中，以后可以重复使用。这个本地仓库存储了项目所需的库文件和插件，使得构建过程更快速，因为不需要每次都从互联网下载。中央仓库：类似于一个全球共享的图书馆。中央仓库是 Maven 社区维护的一个公共存储库，其中包含了大量的开源库文件和插件。当你在 Maven 项目中声明依赖项时，如果没有指定其他远程仓库，Maven 会自动从中央仓库下载所需的依赖项。
Maven远程仓库配置
亮Orz的博客
04-06 735
Maven远程仓库配置
Maven远程仓库的各种配置
Aplumage的专栏
10-11 5494
1.远程仓库的配置 在平时的开发中，我们往往不会使用默认的中央仓库，默认的中央仓库访问的速度比较慢，访问的人或许很多，有时候也无法满足我们项目的需求，可能项目需要的某些构件中央仓库中是没有的，而在其他远程仓库中有，如JBoss Maven仓库。这时，可以在pom.xml中配置该仓库，代码如下： <!-- 配置远程仓库 --> <repositories> <repository> <id>jb
maven 配置多个仓库的方法
09-07
主要介绍了maven 配置多个仓库的方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
阿里云远程Maven仓库配置文件
06-05
使用阿里云远程Maven仓库，更快的下载速度，可以通过修改<localRepository>D:/Repository 来确认本地仓库地址。
Maven配置仓库，详细教程
07-20
当你在项目中需要特定的依赖项或插件，而这些不在中央仓库中，你可以配置远程仓库的位置，以便 Maven 可以从远程仓库中下载所需的文件。 Maven配置本地仓库 1、在maven安装目录下新建文件夹 repository 作为本地仓库...
Maven的常用基本命令
wangyufei0815的博客
04-22 423
解释：这条命令会编译项目中的所有Java源代码，并将编译后的.class文件放置在目标目录下的classes子目录中。功能：执行package命令后，还将打包的结果安装到本地Maven仓库中，以便其他本地项目可以作为依赖引用。解释：在安装到本地仓库的基础上，deploy命令会将打包后的工件上传到远程仓库，供其他项目远程依赖。功能：安装到本地仓库，并发布到远程仓库，如公司私有仓库或公共仓库如Maven Central。功能：编译源代码，运行测试，并将项目打包成可发布的格式，如JAR、WAR或EAR。
maven compile无效的标记: --release
夜曲的博客
04-24 182
如果你的项目是多模块的，可以参考下，这个问题应该是切换JDK版本导致，maven编译时依赖了不符合运行时的JDK版本。解决办法也很简单，找到maven settings.xml里的localRepository配置，进入这个文件夹里，把你当前项目的包名如：com.abc，按这个顺序进入文件夹，把abc文件夹删除。然后重新mvn install搞定。原因就是maven优先使用本地仓库的依赖，但本地仓库是切换JDK版本之前的JDK编译的，所以不兼容。看了好几篇文章，都没有提到这个解决办法，决定写一篇文章。
Maven | 依赖
最新发布
很开心你能来~
04-24 476
Maven--依赖
Maven基础篇1
m0_52474839的博客
04-22 299
项目2需要用到项目3需要将项目三作为资源配置到项目二也就是dependecy中加入项目三的gav两点注意事项：使用项目三，直接将其gav添加到依赖中，使用项目三，项目三不能感知到，自己有相关资源依赖传递：就是自己使用的资源如果是jar包，那么jar资源使用的依赖自己也可以使用就像上图那样一层一层的传递下去；依赖传递分为：直接依 赖，间接依赖。
maven配置远程仓库代码
09-08
Maven是一个开源的项目管理工具，使用它可以更方便地构建、管理和发布项目。配置远程仓库是使用Maven的一个重要环节，它可以帮助我们引入和下载所需的依赖库。 以下是配置远程仓库的步骤： 1. 打开Maven项目的pom.xml文件，该文件是Maven项目的核心配置文件。 2. 在pom.xml文件中，找到<repositories>节点，该节点用于配置远程仓库信息。 3. 在<repositories>节点下，添加<repository>子节点，并在其中配置仓库信息。 4. 配置<repository>子节点的属性，其中包括<id>、<url>和<releases>等。 - <id>用于唯一标识仓库，一般可以使用仓库的名称或者URL。 - <url>是远程仓库的URL地址，可以是公共仓库、私有仓库或者本地仓库的URL。 - <releases>用于配置仓库的发布策略，可以设置为true或者false。如果设置为true，则表示从该仓库下载项目的正式版本。 5. 配置完<repository>子节点后，保存pom.xml文件。 6. 在使用Maven构建项目时，Maven将会根据配置的远程仓库信息，从远程仓库中下载所需的依赖库。 需要注意的是，远程仓库一般需要有相应的权限，才能从中下载依赖库。因此，在配置远程仓库之前，需要确保已经获得了访问该仓库的权限。 以上就是使用Maven配置远程仓库的简单步骤。配置好远程仓库后，我们就可以方便地引入所需的第三方库，并构建我们的项目了。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值