Maven Repository vs Mirror 深度解析：多倉庫配置最佳實踐

核心概念區別

Repository 多倉庫配置實戰

方式一：多 Profile + activeProfiles（推薦區分環境）

<profiles>
  <profile>
    <id>aliyun</id>
    <repositories>
      <repository>
        <id>aliyun</id>
        <url>https://maven.aliyun.com/nexus/content/groups/public</url>
        <releases><enabled>true</enabled></releases>
        <snapshots><enabled>true</enabled></snapshots>
      </repository>
    </repositories>
    <pluginRepositories>...</pluginRepositories>
  </profile>
  <profile>
    <id>central</id>
    <repositories>
      <repository><id>central</id><url>https://repo.maven.apache.org/maven2</url>...</repository>
    </repositories>
  </profile>
</profiles>
<activeProfiles>
  <activeProfile>aliyun</activeProfile>
  <activeProfile>central</activeProfile>
</activeProfiles>

Maven 會按 activeProfiles 順序依次嘗試下載。

方式二：單 Profile 多 Repository（簡單項目）

<profile>
  <id>multi-repo</id>
  <repositories>
    <repository><id>aliyun</id><url>...</url>...</repository>
    <repository><id>central</id><url>...</url>...</repository>
    <repository><id>private</id><url>https://nexus.company.com/repository/maven-public/</url>...</repository>
  </repositories>
</profile>

Mirror 配置與陷阱

典型配置：全局鏡像中央倉庫到阿里雲

<mirrors>
  <mirror>
    <id>aliyun-mirror</id>
    <mirrorOf>central</mirrorOf> <!-- 只鏡像 central -->
    <name>Aliyun Mirror</name>
    <url>https://maven.aliyun.com/nexus/content/groups/public</url>
  </mirror>
</mirrors>

危險配置：mirrorOf>*（鏡像所有倉庫）

<mirror>
  <id>dangerous</id>
  <mirrorOf>*</mirrorOf> <!-- 攔截所有請求，包括私服、第三方 -->
  <url>https://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>

後果：私服部署的內部構件、第三方倉庫的專有包全部無法解析，構建失敗。

多 Mirror 同一倉庫：僅作備份

<mirror><id>mirror1</id><mirrorOf>central</mirrorOf><url>https://mirror1.com</url></mirror>
<mirror><id>mirror2</id><mirrorOf>central</mirrorOf><url>https://mirror2.com</url></mirror>

只有 mirror1 連不上時才嘗試 mirror2；若 mirror1 連得上但缺包，構建直接失敗，不會嘗試 mirror2。

最佳實踐建議

1. 優先用 Repository 多倉庫順序嘗試：彈性最高，缺包自動嘗試下一個。
2. Mirror 僅用於「替換中央倉庫為國內鏡像」：mirrorOf>central，不加 *。
3. 私服（Nexus/Artifactory）聚合所有上游：Maven 只配一個 repository 指向私服，由私服代理中央、阿里雲、第三方、內部倉庫，統一緩存、統一權限、統一掃描——這才是企業級標準架構。
4. settings.xml 與 pom.xml 結合：全局鏡像放 settings.xml，項目特有倉庫放 pom.xml。

總結

Repository 是「選擇」，Mirror 是「攔截替換」。多倉庫場景下，Repository 順序嘗試機制遠優於 Mirror 備份機制。企業級項目請直接上私服，別在 Maven 這裡搞複雜邏輯。