Maven中配置mirrorOf

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,723评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,080评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,604评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,440评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,431评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,499评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,893评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,541评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,751评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,547评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,619评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,320评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,890评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,896评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,137评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,796评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,335评论 2 342