Maven配置多个仓库共同使用的方法-个人计算机技术知识记录

Maven是Java的项目配置管理工具，用来管理依赖，具体的用途就不展开说了。大部分项目，配置一个镜像仓库地址就可以了（单个mirror）。但是有的网上下载的项目需要从多个仓库查找对应的包，从网上找了很多帖子，配置Maven的settings.xml文件中的多个仓库，都是从一个地方复制粘贴的，方法说的都不对。今天自己研究了一下，分享给大家。

最终的settings.xml文件配置

如果你不想看具体的配置，可以直接把我下面这个配置拿走，修改一下localRepository部分对应自己的本地repo(通常为～/.m2/repository)，然后将settings.xml替换${MAVEN_HOME}/conf/settings.xml即可。

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 http://maven.apache.org/xsd/settings-1.2.0.xsd">
  <localRepository>/Users/chris/.m2/repository</localRepository>
  <pluginGroups></pluginGroups>
  <proxies></proxies>
  <servers></servers>
  <mirrors></mirrors>
 
  <profiles>
    <profile>
      <id>aliyun</id> 
      <repositories>
        <repository>
          <id>aliyun</id> 
          <url>https://maven.aliyun.com/repository/public</url> 
          <releases>
            <enabled>true</enabled>
          </releases> 
          <snapshots>
            <enabled>true</enabled> 
            <updatePolicy>always</updatePolicy>
          </snapshots>
        </repository>
      </repositories>
    </profile>
    <profile>
      <id>pentaho</id>
      <repositories>
        <repository>
          <id>pentaho</id>
          <url>https://nexus.pentaho.org/content/repositories/omni/</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
          </snapshots>
        </repository>
      </repositories>
    </profile>
    <profile>
      <id>repo1</id>
      <repositories>
        <repository>
          <id>repo1</id>
          <url>https://repo1.maven.org/maven2</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
          </snapshots>
        </repository>
      </repositories>
    </profile>
    <profile>
      <id>repo2</id>
      <repositories>
        <repository>
          <id>repo2</id>
          <url>https://repo2.maven.org/maven2</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
          </snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>
 
  <activeProfiles>
  <activeProfile>aliyun</activeProfile>
  <activeProfile>pentaho</activeProfile>
  <activeProfile>repo1</activeProfile>
  <activeProfile>repo2</activeProfile>
 
</activeProfiles>
</settings>

settings.xml相关具体配置介绍

Mirrors标签部分

通常用来定义镜像仓库（repository），指定用来下载对应依赖和插件的仓库地址。使用Mirrors的理由如下：

配置一个就近加速的网络仓库；
配置一个你本地创建的镜像仓库；

来自Maven官方的Mirrors配置示例如下：

<settings>
  ...
  <mirrors>
    <mirror>
      <id>other-mirror</id>
      <name>Other Mirror Repository</name>
      <url>https://other-mirror.repo.other-company.com/maven2</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>
  ...
</settings>

在Mirrors部分可以配置多个镜像仓库，但是在该部分配置多个仓库，并不能提供自动查询多个仓库的功能，默认还是取第一个仓库进行查询。

Profiles标签部分

settings.xml中的profile部分，包括4个二级子标签：activation, repositories, pluginRepositories and properties。profile部分的内容需要在下面进行激活。这里介绍多个镜像共同使用仅介绍Repositories部分。

Repositories

配置方式如下，指定repo地址、id：

  <profiles>
    <profile>
      <id>repo2</id>
      <repositories>
        <repository>
          <id>repo2</id>
          <url>https://repo2.maven.org/maven2</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
          </snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>

Active Profiles标签部分

settings.xml配置文件最后的一部分就是激活公用多个仓库的重点activeProfiles。包含多个activeProfile元素，每一个activeProfile元素都用来指定一个上部分profile的id，也就是说，每指定一个activeProfile映射，就激活一个profile，将会覆盖其他任何环境配置。

大家从如下例子里，可以看到我配置了aliyun、pentaho、repo1和repo2四个仓库，这样再执行mvn命令，他就会从这四个仓库循环去查找包，第一个找不到就去第二个找。。。

<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 https://maven.apache.org/xsd/settings-1.0.0.xsd">
  ...
<activeProfiles>
  <activeProfile>aliyun</activeProfile>
  <activeProfile>pentaho</activeProfile>
  <activeProfile>repo1</activeProfile>
  <activeProfile>repo2</activeProfile>
</activeProfiles>
</settings>

注意事项

可能是我还没有太深入去研究：其中如果在mirrors里面配置了全局镜像加速节点，会让下面配置profiles 节点配置不生效。(原因找到了，是因为配置mirrors全局节点，有一个配置项mirrorOf不能配置为”*“)~~如果mirrors节点配置多个，生效的也会有一个。默认是第一个~~。如果要配置私有仓库，应该也是在profiles里面配置，在servers节点添加私有仓库的账号密码信息。

你可以去maven官方查看上面的介绍，上面的介绍主要说明了mirrorOf的用法和作用。

或者在这里继续看下去：

mirrors <mirrorOf>详解

先说mirrors中mirror的作用，mirrors允许配置多个镜像mirror，mirror的作用一般是为了使用一个更快速度的镜像，主要是访问速度的考虑，或者突破屏蔽使用可以访问的镜像。

在maven中不配置mirror时使用的maven的中央库。

在maven中配置一个mirror时，mirror通常会设置成*，还有可能是一个具体的值，还有可能是逗号隔开的几个值…

例如:

1.*

2.repo3

3.repo1,repo2,*,!repo3

4.external:*

在上面4个例子中，第一个例子中*的意思就是（根据mirrorOf和repository的id）匹配所有的库（repository），这样就是说如果你需要某个jar，他会从镜像地址去下载这个jar。不管你配置了多少个库，即使这些库的地址不一样，仍然会从镜像地址访问，这里就产生了问题。

问题：为什么我配置好了库（repository），但是下载不下来（或者下载地址不对）？

这个问题已经很明白了，就是镜像（mirror）的问题。

问题：如何解决上述问题呢？

这里请继续看第二个例子和第三个例子。

第二个例子只配置了一个repo3，这个镜像只能匹配id是repo3的库，该库会使用repo3的镜像访问。这里说重点了，即使还存在一个*的，这里会先查找完全相同的存储库标识符匹配的镜像，如果找到了，就用匹配的，这里就是repo3，这点可以放心。如果找不到，那就去根据其他的mirrorOf查找去，查找到一个就使用。这里需要注意的是，如果存在多个重复的mirrorOf，只会用排名靠前的第一个（按照配置顺序来）。如果一个都没有，就会用maven中央库。

第三个例子是用逗号隔开的好几个，并且有一个特殊的!repo3，一般!的意思是非，这里的意思就是，就是排除repo3的情况。综合起来第三个的含义就是完全匹配repo1,repo2和其他全部库，排除repo3库。

到这里，第二个问题已经有了答案，给这个库配置单独的镜像，而且位置尽量在前面，id和mirrorOf一致。说到这两个一致，还得说两个不能一致的情况，就是mirror的mirrorOf不能和任何mirror的id一致，因为id在setting中唯一，mirrorOf要和库的id一致，所以势必不能和mirror的id一致，如果一致显然就起不到作用了（这里属于猜测，官方要求不能一致）。

第四个例子很特殊，含义就是匹配本地库之外的全部库。如果本地库存在，就用本地库的。

例子：

  <mirror>      
    <id>奇葩-mirror</id>    
    <name>奇葩-mirror</name>  
    <url>https://奇葩/repo/</url>    
    <mirrorOf>central</mirrorOf>      
  </mirror>   
  
  <mirror>      
    <id>nexus-aliyun</id>    
    <name>nexus-aliyun</name>  
    <url>http://maven.aliyun.com/nexus/content/groups/public</url>    
    <mirrorOf>*</mirrorOf>      
  </mirror>

到这里，有关mirrorOf的内容说完了，记录下我解决问题的思路和原因以及解决办法，希望对你有所帮助。

目录CONTENT

Maven配置多个仓库共同使用的方法