总结：Maven多仓库多镜像源配置

一·核心概念：仓库（Repository）与镜像（Mirror）

在讲解配置前，需先明确两个核心概念的区别：

二、多仓库配置：原理与方式

Maven 支持配置多个远程仓库，用于获取不同来源的依赖（例如：中央仓库没有的依赖，可能在 Spring 仓库、Google 仓库中存在）。

1. 仓库的分类

（1）本地仓库：

默认位于~/.m2/repository ，所有下载的依赖都会缓存到这里，优先从本地仓库获取依赖。

（2）远程仓库：三类

• 中央仓库（Maven 默认内置）： https://repo1.maven.org/maven2/ ，存储大部分开源依赖。
• 第三方仓库： 例如，Spring 仓库（https://repo.spring.io/release/）、Google 仓库（https://maven.google.com/）等，存储特定框架的依赖。
• 私有仓库： 企业内部搭建的仓库（如 Nexus、Artifactory），存储内部构件或代理外部仓库。

2. 多仓库的配置位置

远程仓库的配置有两个级别，优先级不同：

3. 多仓库配置示例

（1）在pom.xml中配置项目级仓库

<project><!-- 其他配置 --><repositories><!-- 中央仓库（Maven默认已内置，可省略） --><repository><id>central</id><name>Maven Central Repository</name><url>https://repo1.maven.org/maven2/</url><releases><enabled>true</enabled> <!-- 允许下载release版本 --></releases><snapshots><enabled>false</enabled> <!-- 禁止下载snapshot版本（不稳定） --></snapshots></repository><!-- Spring仓库（获取Spring相关依赖） --><repository><id>spring-releases</id><name>Spring Releases Repository</name><url>https://repo.spring.io/release/</url><releases><enabled>true</enabled></releases><snapshots><enabled>false</enabled></snapshots></repository><!-- Google仓库（获取Android相关依赖） --><repository><id>google</id><name>Google Repository</name><url>https://maven.google.com/</url><releases><enabled>true</enabled></releases><snapshots><enabled>false</enabled></snapshots></repository></repositories>
</project>

（2）在maven安装目录/conf/settings.xml中配置全局级仓库

<settings><!-- 其他配置 --><profiles><profile><id>custom-repos</id><repositories><!-- 私有仓库（企业内部依赖） --><repository><id>company-private</id><url>http://nexus.company.com/repository/maven-public/</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled></snapshots></repository><!-- 其他共用仓库 --></repositories></profile></profiles><!-- 激活上述profile，使其生效 --><activeProfiles><activeProfile>custom-repos</activeProfile></activeProfiles>
</settings>

4. 多仓库配置注意事项

• 仓库 ID 唯一性： 每个仓库的id必须唯一（Maven 通过id识别仓库），否则会导致冲突。
• releases/snapshots开关： 通过enabled控制是否允许从该仓库下载正式版 / 快照版依赖（快照版不稳定，生产环境通常关闭）。
• 优先级： pom.xml中的仓库优先级高于settings.xml，即项目级配置会覆盖全局配置（如需全局生效，建议配置在settings.xml）。

三、多镜像源配置：原理与规则

镜像的核心作用是 “替代远程仓库”，当配置多个镜像时，需通过mirrorOf属性明确每个镜像替代哪些仓库，避免冲突。

1. 镜像的配置位置

镜像只能在settings.xml的<mirrors>标签中配置（全局生效），无法在pom.xml中配置（保证镜像的全局统一性）。

2. 多镜像配置的核心：mirrorOf规则

mirrorOf是镜像配置的灵魂，用于指定 “当前镜像替代哪些仓库”，其值通过仓库的id匹配（仓库id在<repository>中定义）。常见规则如下：

3. 多镜像配置示例

假设需求：用阿里云加速中央仓库，用华为云加速 Spring 仓库，同时保留私有仓库直接访问。

<settings><!-- 其他配置 --><mirrors><!-- 1. 阿里云镜像：替代中央仓库（id=central） --><mirror><id>aliyun-central</id><name>Aliyun Mirror for Central</name><url>https://maven.aliyun.com/repository/central</url><mirrorOf>central</mirrorOf> <!-- 仅替代中央仓库 --></mirror><!-- 2. 华为云镜像：替代Spring仓库（id=spring-releases） --><mirror><id>huawei-spring</id><name>Huawei Mirror for Spring</name><url>https://repo.huaweicloud.com/repository/spring/</url><mirrorOf>spring-releases</mirrorOf> <!-- 仅替代Spring仓库 --></mirror><!-- 3. 全局镜像：替代所有仓库，但排除私有仓库（id=company-private） --><mirror><id>global-mirror</id><name>Global Mirror (exclude private)</name><url>https://repo.example.com/maven/</url><mirrorOf>*,!company-private</mirrorOf> <!-- 排除私有仓库 --></mirror></mirrors>
</settings>

4. 多镜像的匹配优先级

Maven 按<mirrors>中镜像的配置顺序匹配，一旦找到第一个符合mirrorOf规则的镜像，就会使用该镜像，后续镜像不再生效。因此：

• 精确匹配的镜像（如mirrorOf=central）应放在模糊匹配镜像（如mirrorOf=*）前面，避免被覆盖。
• 优先级高的镜像（如速度快的国内镜像）应放在前面。

四、多仓库与多镜像的协同工作流程

当 Maven 需要下载一个依赖时，整体流程如下：

（1）检查本地仓库：如果依赖已存在，直接使用，流程结束。

（2）查找远程仓库：根据pom.xml或settings.xml中配置的远程仓库列表，确定需要访问的仓库（按配置顺序）。

（3）匹配镜像：对每个远程仓库，检查是否有镜像的mirrorOf匹配该仓库的id：

• 若有匹配的镜像，使用镜像地址下载依赖。
• 若没有匹配的镜像，直接访问原仓库地址下载。

（4）缓存到本地仓库（仅只有一个）：下载成功后，将依赖缓存到本地仓库，供后续使用

五·总结：

（1）多仓库解决 “依赖来源多样性” 问题，通过配置多个远程仓库获取不同构件，可在pom.xml（项目级）或settings.xml（全局级）中配置。

（2）多镜像解决 “下载效率与统一管理” 问题，通过mirrorOf规则指定替代的仓库，仅在settings.xml中配置。

（3）核心是理解mirrorOf的匹配规则和镜像与仓库的协同流程，避免镜像覆盖必要的仓库，确保依赖能正常下载。