Maven 镜像优先级配置指南

在 settings.xml 中配置镜像时，优先级由声明顺序决定，Maven 会从上到下匹配镜像规则。当多个镜像匹配同一仓库时，第一个匹配的镜像生效。以下是关键配置原则：

1. 镜像匹配规则

镜像通过 <mirrorOf> 标签匹配仓库：

• 精确匹配：<mirrorOf>central</mirrorOf>（只匹配中央仓库）
• 通配符匹配：<mirrorOf>*</mirrorOf>（匹配所有仓库）
• 排除匹配：<mirrorOf>*,!private-repo</mirrorOf>（匹配除 private-repo 外的所有仓库）

2. 优先级配置策略

<mirrors>
  <!-- 1. 高优先级：特定仓库镜像放最前 -->
  <mirror>
    <id>aliyun-central</id>
    <mirrorOf>central</mirrorOf>  <!-- 精确匹配中央仓库 -->
    <url>https://maven.aliyun.com/repository/central</url>
  </mirror>
  
  <!-- 2. 中优先级：自定义私有仓库 -->
  <mirror>
    <id>internal-mirror</id>
    <mirrorOf>internal-repo</mirrorOf> <!-- 精确匹配私有仓库 -->
    <url>https://internal.com/repo</url>
  </mirror>
  
  <!-- 3. 低优先级：通配镜像放最后 -->
  <mirror>
    <id>global-mirror</id>
    <mirrorOf>*</mirrorOf>  <!-- 兜底匹配所有仓库 -->
    <url>https://backup.mirror/repo</url>
  </mirror>
</mirrors>

3. 验证配置

使用命令检查生效镜像：

mvn help:effective-settings | grep -A5 '<mirrors>'

4. 最佳实践

1. 精确匹配优先：将特定仓库（如 central）的镜像放在顶部
2. 避免冲突：不同镜像的 <mirrorOf> 范围不应重叠
3. 排除机制：需排除的仓库用 ! 声明，例如：

   <mirrorOf>*,!jitpack.io</mirrorOf>  <!-- 所有仓库除 jitpack 外 -->
   

4. ID 唯一性：每个 <id> 必须唯一

完整配置示例

<settings>
  <mirrors>
    <!-- 1. 中央仓库加速 -->
    <mirror>
      <id>aliyun-central</id>
      <name>Aliyun Central</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
    
    <!-- 2. 自定义私有仓库 -->
    <mirror>
      <id>internal-repo-mirror</id>
      <url>https://mirror.internal/nexus</url>
      <mirrorOf>internal-repo-id</mirrorOf> 
    </mirror>
    
    <!-- 3. 兜底镜像（排除Gradle插件仓库） -->
    <mirror>
      <id>global-backup</id>
      <url>https://mirror.example.com/repo</url>
      <mirrorOf>*,!gradle-plugin-portal</mirrorOf>
    </mirror>
  </mirrors>
</settings>

关键点：Maven 按声明顺序逐条检查镜像规则，首次匹配成功后即终止查询。因此应将最具体的镜像声明放在最前面，通用镜像放在末尾。