Maven中配置mirrorOf

在java的maven项目中编译时经常会配置maven的mirrorOf，例如在settings文件中配置aliyun的仓库：

        nexus-aliyun

        *  //代理仓库配置

        Nexus aliyun

        http://maven.aliyun.com/nexus/content/groups/public

mirrorOf可以理解“为某个仓库（repository）的做镜像”，填写的是repostoryId。”*“ 的意思就是匹配所有的仓库（repository）。相当于一个拦截器，它会拦截maven对remote repository的相关请求，把请求里的remote repository地址，重定向到mirror里配置的地址。

我们知道maven仓库有jar仓库和plugin仓库，例如pom中配置仓库，如下：

   

      repo.jenkins-ci.org  //repostoryId 

      https://repo.jenkins-ci.org/public/

   

 

也可以配置在settings.xml中，settings.xml中的profile元素是pom.xml中profile元素的裁剪版本。它包含了id、activation、repositories、pluginRepositories和 properties元素。例如节点中配置如下：

 

 

   

    my-repo-id  //repostoryId

    repo name

http://maven.aliyun.com/nexus/content/groups/public

   

      true

   

      true

   

    default

 

mirrorOf=“*”时镜像所有的repositoryId，包括repositories和pluginRepositories。如果你需要某个jar就会从镜像mirrorOd配置的地址去下载这个jar。其他配置的repostory都没用。

当然你也可以配置mirrorOf镜像你自己的repository仓库，例如你想镜像my-repo-id，你把mirrorOf配置成my-repo-id，那么你配置的my-repo-id这个仓库的url就没用了，被镜像代表了。

      nexus-aliyun

my-repo-id  //镜像 my-repo-id仓库，使用下面配置的url下载

        Nexus aliyun

        http://maven.aliyun.com/nexus/content/groups/public

在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根据配置顺序搜索