Maven中配置mirrorOf

当maven需要到的依赖jar包不在本地仓库时, 就需要到远程仓库下载 .

这个时候如果mavensetting.xml中配置了镜像 , 而且镜像配置的规则中匹配到目标仓库时 ,
maven认为目标仓库被镜像了, 不会再去被镜像仓库下载依赖jar包, 而是直接去镜像仓库下载.

简单而言, mirror可以拦截对远程仓库的请求 , 改变对目标仓库的下载地址。

在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>节点中配置如下：

   <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>

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

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

在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配置了阿里的镜像 , 而项目中需要使用到一些第三方jar包, 为了方便引入 , 已上传到192.168.0.201的nexus私服下。

但由于个人maven阿里的镜像使用默认mirrorOf规则=*, 所有的仓库都被镜像 , 不会再去192.168.0.201下下载第三方jar包。

上传的第三方jar包目标路径 :

http://192.168.0.201:8081/nexus/content/groups/public/com/alipay/sdk-java/20170615110434/sdk-java-20170615110434.pom

被镜像后路径 :

http://maven.aliyun.com/nexus/content/groups/public/com/alipay/sdk-java/20170615110434/sdk-java-20170615110434.pom

所以需要修改镜像的mirrorOf规则 , 避免默认从镜像中下载

maven的conf/setting.xml

<mirrors>
        <!--国内阿里云提供的镜像，非常不错-->
    <mirror>
        <!--This sends everything else to /public -->
        <id>aliyun_nexus</id>
        <!--对所有仓库使用该镜像,除了一个名为maven_nexus_201的仓库除外-->
        <!--这个名为maven_nexus_201的仓库可以在javamaven项目中配置一个repository-->
        <mirrorOf>*,!maven_nexus_201</mirrorOf> 
        <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
    </mirror>
  </mirrors>

 

https://www.jianshu.com/p/c4f02c5bdfc7

https://www.jianshu.com/p/274c363ffd7c