在java的maven项目中编译时经常会配置maven的mirrorOf,例如在settings文件中配置aliyun的仓库:
<mirror>
<id>nexus-aliyun</id>
<mirrorOf>*</mirrorOf> //代理仓库配置
<name>Nexus aliyun</name>
<url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>
mirrorOf可以理解“为某个仓库(repository)的做镜像”,填写的是repostoryId。”*“ 的意思就是匹配所有的仓库(repository)。相当于一个拦截器,它会拦截maven对remote repository的相关请求,把请求里的remote repository地址,重定向到mirror里配置的地址。
我们知道maven仓库有jar仓库和plugin仓库,例如pom中配置仓库,如下:
<repositories>
<repository>
<id>repo.jenkins-ci.org</id> //repostoryId
<url>https://repo.jenkins-ci.org/public/</url>
</repository>
</repositories>
也可以配置在settings.xml中,settings.xml中的profile元素是pom.xml中profile元素的裁剪版本。它包含了id、activation、repositories、pluginRepositories和 properties元素。例如<profiles>节点中配置如下:
<repositories>
<!--包含远程仓库的信息 -->
<repository>
<!--远程仓库唯一标识 -->
<id>my-repo-id</id> //repostoryId
<name>repo name</name>
<url>http://maven.aliyun.com/nexus/content/groups/public</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
<layout>default</layout>
</repository>
</repositories>
mirrorOf=“*”时镜像所有的repositoryId,包括repositories和pluginRepositories。如果你需要某个jar就会从镜像mirrorOd配置的地址去下载这个jar。其他配置的repostory都没用。
当然你也可以配置mirrorOf镜像你自己的repository仓库,例如你想镜像my-repo-id,你把mirrorOf配置成my-repo-id,那么你配置的my-repo-id这个仓库的url就没用了,被镜像代表了。
<mirror>
<id>nexus-aliyun</id>
my-repo-id //镜像 my-repo-id仓库,使用下面配置的url下载
<name>Nexus aliyun</name>
<url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>
在maven中配置一个mirror时,有多种形式,例如:
mirrorOf=“*” //刚才经过,mirror一切,你配置的repository不起作用了
mirrorOf=my-repo-id //镜像my-repo-id,你配置的my-repo-id仓库不起作用了
mirrorOf=*,!my-repo-id //!表示非运算,排除你配置的my-repo-id仓库,其他仓库都被镜像了。就是请求下载my-repo-id的仓库的jar不使用mirror的url下载,其他都是用mirror配置的url下载
mirrorOf=external:* //如果本地库存在就用本地库的,如果本地没有所有下载就用mirror配置的url下载
我们知道apache-maven的settings.xml不做任何配置时是有默认的仓库的,这个仓库就是central仓库,默认值是https://repo.maven.apache.org/maven2/,我们可以配置mirrorOf=central只镜像默认的central仓库。如果你只配置了mirrorOf=”my-repo-id“没有配置central或*,那么请求maven会判断,首先在默认的central仓库https://repo.maven.apache.org/maven2/找依赖,如果找不到就去my-repo-id对应的仓库找,遍历所有仓库后找不到就报错。
maven默认仓库的搜索顺序如下:
本地仓库> settings_profile_repo > pom_profile_repo > pom_repositories > settings_mirror > central。如下错误,先搜索pom配置的仓库,然后找默认的central仓库,如下:
[INFO] Scanning for projects...
Downloading: http://maven.aliyun.com/nexus/content/groups/public/org/jenkins-ci/plugins/plugin/4.1/plugin-4.1.pom //pom仓库my-repo-id并在mirrorOf="my-repo_id"
Downloading: https://repo.maven.apache.org/maven2/org/jenkins-ci/plugins/plugin/4.1/plugin-4.1.pom //默认central仓库,搜索优先级最低
变了所有的仓库找不到依赖则报错
[ERROR] [ERROR] Some problems were encountered while processing the POMs:
[FATAL] Non-resolvable parent POM for org.csanchez.jenkins.plugins:kubernetes:1.25.4: Could not find artifact org.jenkins-ci.plugins:plugin:pom:4.1 in nexus-aliyun (http://maven.aliyun.com/nexus/content/groups/public) and 'parent.relativePath' points at no local POM @ line 3, column 11
所以如果你有如下问题,可能需要如下配置:
1、你需要使用阿里云做为central仓库(默认仓库)代替默认central,可以配置mirrorOf=“*/central”
2、你配置了pom.xml中仓库并想使用(不被镜像屏蔽),可以配置mirrorOf=“*,!my-repo-id”
可能时你maven的settings.xml配置mirror导致的问题。
1、pom.xml配置了仓库repository,不生效。检查是不是mirrorOf="*"
2、pom.xml配置依赖插件下载不了,可能时你没有配置pluginRepositories或者mirrorOf<>"*"
3、mirrorOf="my-repo-id"编译失败,首先确认my-repo-id仓库存在且配置正确,然后确认是不是my-repo-id不存在依赖jar
4、如果配置多个mirror,首先按照搜索顺序优先级搜索,相同优先级的repository根据配置顺序搜索