在 Maven 中配置多個(gè)鏡像源，主要是為了解決依賴(lài)包在不同地區(qū)下載速度不同的問(wèn)題，或者為了使用特定的私有倉(cāng)庫(kù)作為依賴(lài)源。Maven 支持在 pom.xml 文件中配置多個(gè)鏡像源（repositories），也可以在 Maven 的全局配置文件 settings.xml 中配置

在項(xiàng)目開(kāi)發(fā)中，使用 Maven 管理依賴(lài)是常見(jiàn)的做法。Maven 的依賴(lài)通常從 倉(cāng)庫(kù)（Repository） 中獲取，主要有兩種類(lèi)型：中央倉(cāng)庫(kù)（Central Repository）和公司私有倉(cāng)庫(kù)。中央倉(cāng)庫(kù)由 Maven 官方維護(hù)，托管了大量的開(kāi)源依賴(lài)，但由于它位于外網(wǎng)，在國(guó)內(nèi)訪問(wèn)時(shí)往往速度較慢甚至無(wú)法連接。因此，許多開(kāi)發(fā)者會(huì)配置 鏡像（Mirror） 來(lái)加速依賴(lài)下載。然而，在配置鏡像時(shí)，可能會(huì)遇到依賴(lài)無(wú)法下載的問(wèn)題，尤其是將鏡像設(shè)置為通配符 * 時(shí)。本文將深入分析這一問(wèn)題，并提供解決方案。

什么是 Maven 鏡像？

Maven 鏡像是一個(gè)代理服務(wù)器，作用是替代原始倉(cāng)庫(kù)地址，提供更快的依賴(lài)下載服務(wù)。鏡像服務(wù)器會(huì)緩存原始倉(cāng)庫(kù)中的依賴(lài)，并在本地或更近的網(wǎng)絡(luò)位置提供服務(wù)，從而加速下載。在國(guó)內(nèi)，常用的鏡像包括阿里云、華為云等提供的 Maven 鏡像倉(cāng)庫(kù)。

在 Maven 的配置文件 settings.xml 中，可以通過(guò) 標(biāo)簽配置鏡像。例如：

<mirror><id>aliyun</id><name>Aliyun Mirror</name><url>https://maven.aliyun.com/repository/public</url><mirrorOf>*</mirrorOf>
</mirror>

這里的 指定了鏡像適用的倉(cāng)庫(kù)范圍。* 表示該鏡像將代理所有倉(cāng)庫(kù)，包括中央倉(cāng)庫(kù)和公司私有倉(cāng)庫(kù)。
標(biāo)簽指定了哪些倉(cāng)庫(kù)的請(qǐng)求會(huì)被鏡像重定向。例如，mirrorOf>central 表示所有到中央倉(cāng)庫(kù)的請(qǐng)求都會(huì)被重定向到 http://central.maven.org/maven2。而 external:* 表示所有非中央倉(cāng)庫(kù)的外部請(qǐng)求都會(huì)被重定向。

mirrorOf

元素定義了哪些倉(cāng)庫(kù)的請(qǐng)求會(huì)被鏡像倉(cāng)庫(kù)捕獲。這個(gè)元素可以接受多種值，包括倉(cāng)庫(kù)ID、通配符模式（*）、逗號(hào)分隔的列表等，用以靈活指定哪些倉(cāng)庫(kù)的請(qǐng)求需要被鏡像。

<mirror><id>example-mirror</id><mirrorOf>central</mirrorOf><url>http://example.com/maven2</url>
</mirror>

在這個(gè)例子中，所有對(duì)中央倉(cāng)庫(kù)（ID為central）的請(qǐng)求都會(huì)被重定向到http://example.com/maven2。

• 指定多個(gè)倉(cāng)庫(kù)

<mirror><id>example-mirror</id><mirrorOf>central,jboss-public-repository</mirrorOf><url>http://example.com/maven2</url>
</mirror>

在這個(gè)例子中，對(duì)中央倉(cāng)庫(kù)和JBoss公共倉(cāng)庫(kù)的請(qǐng)求都會(huì)被重定向到http://example.com/maven2。

如何知道需要重鏡像的？

檢查現(xiàn)有倉(cāng)庫(kù)配置：首先查看你的項(xiàng)目中是否已經(jīng)配置了特定的倉(cāng)庫(kù)（例如中央倉(cāng)庫(kù)central），或者是否有特定依賴(lài)需要從特定的非標(biāo)準(zhǔn)倉(cāng)庫(kù)獲取。這些信息通常在項(xiàng)目的pom.xml文件中定義，或者在父POM中定義。

分析依賴(lài)：使用Maven的依賴(lài)樹(shù)查看工具（如mvn dependency:tree），分析項(xiàng)目依賴(lài)是從哪些倉(cāng)庫(kù)下載的。這可以幫助你了解哪些倉(cāng)庫(kù)是你需要鏡像的。

考慮性能和安全：如果你發(fā)現(xiàn)某些倉(cāng)庫(kù)訪問(wèn)速度慢或者出于安全考慮需要使用私有倉(cāng)庫(kù)，那么你可能需要為這些倉(cāng)庫(kù)設(shè)置鏡像。

參考文檔和最佳實(shí)踐：查閱Maven官方文檔關(guān)于鏡像配置的部分，了解不同配置項(xiàng)的含義和最佳實(shí)踐。Maven官方文檔通常會(huì)提供詳細(xì)的指導(dǎo)和示例。

通過(guò)上述步驟，你可以有效地確定哪些倉(cāng)庫(kù)需要配置鏡像，并相應(yīng)地設(shè)置元素。這樣，Maven在構(gòu)建過(guò)程中就能根據(jù)配置將請(qǐng)求重定向到正確的鏡像倉(cāng)庫(kù)，從而提高構(gòu)建效率和穩(wěn)定性。

maven 多個(gè)鏡像如何自動(dòng)切換

在 Maven 的 settings.xml 文件中配置多個(gè)鏡像，并為每個(gè)鏡像設(shè)置特定的條件（如地理位置）。這樣可以根據(jù)不同的環(huán)境自動(dòng)選擇合適的鏡像。

<settings><mirrors><mirror><id>mirror-china</id><mirrorOf>central</mirrorOf><name>Aliyun Mirror</name><url>https://maven.aliyun.com/repository/central</url></mirror><mirror><id>mirror-us</id><mirrorOf>central</mirrorOf><name>Maven Central</name><url>https://repo.maven.apache.org/maven2</url></mirror></mirrors>
</settings>

這種方式需要手動(dòng)選擇或修改配置文件來(lái)切換鏡像。

2. 使用環(huán)境變量或命令行參數(shù)動(dòng)態(tài)指定鏡像
   通過(guò)設(shè)置環(huán)境變量或在命令行中指定 -D 參數(shù)來(lái)動(dòng)態(tài)指定鏡像。例如，使用環(huán)境變量：

export MAVEN_OPTS="-Dmaven.repo.remote=https://maven.aliyun.com/repository/central"
mvn clean install

或者通過(guò)命令行參數(shù)：

mvn clean install -Dmaven.repo.remote=https://maven.aliyun.com/repository/central

4. 使用 Jenkins 或其他 CI/CD 工具的插件或配置
   如果你在使用 Jenkins 或其他 CI/CD 工具，可以利用插件或配置文件來(lái)根據(jù)構(gòu)建環(huán)境自動(dòng)選擇合適的 Maven 鏡像。例如，在 Jenkins 中可以為不同的 job 配置不同的 Maven 設(shè)置。

5. 使用 Docker 和自定義 Dockerfile
   如果你使用 Docker，可以在 Dockerfile 中預(yù)先設(shè)置好 Maven 的配置，或者在構(gòu)建過(guò)程中通過(guò)腳本動(dòng)態(tài)設(shè)置 Maven 鏡像。例如：

FROM maven:3.6.3-jdk-11
RUN sed -i 's|http://repo.maven.apache.org/maven2|https://maven.aliyun.com/repository/central|g' /usr/share/maven/conf/settings.xml

問(wèn)題場(chǎng)景：依賴(lài)無(wú)法下載

假設(shè)你在項(xiàng)目中配置了一個(gè)鏡像， 設(shè)置為 *，希望所有依賴(lài)都通過(guò)該鏡像下載。然而，運(yùn)行 mvn install 時(shí)，Maven 報(bào)錯(cuò)，提示某些依賴(lài)無(wú)法找到。你檢查了中央倉(cāng)庫(kù)，發(fā)現(xiàn)這些依賴(lài)確實(shí)存在。這是怎么回事呢？
問(wèn)題原因
問(wèn)題的根源在于鏡像的覆蓋范圍和鏡像倉(cāng)庫(kù)的同步能力：

1. 鏡像覆蓋范圍（mirrorOf=） ：
   當(dāng) 被配置時(shí)，Maven 會(huì)將所有倉(cāng)庫(kù)的請(qǐng)求（包括中央倉(cāng)庫(kù)和公司私有倉(cāng)庫(kù)）重定向到該鏡像。這意味著 Maven 不再直接訪問(wèn)原始倉(cāng)庫(kù)，而是完全依賴(lài)鏡像提供的依賴(lài)。
2. 鏡像同步不完整：
   鏡像倉(cāng)庫(kù)通常會(huì)定期從中央倉(cāng)庫(kù)同步依賴(lài)，但同步可能不完整。某些較新的依賴(lài)、冷門(mén)依賴(lài)或剛剛發(fā)布的依賴(lài)可能尚未被鏡像倉(cāng)庫(kù)緩存。如果 Maven 只訪問(wèn)鏡像，而鏡像中缺少這些依賴(lài)，就會(huì)導(dǎo)致下載失敗。
3. 公司私有倉(cāng)庫(kù)被覆蓋：
   如果你的項(xiàng)目還依賴(lài)公司私有倉(cāng)庫(kù)（比如 Nexus 或 Artifactory），* 會(huì)將私有倉(cāng)庫(kù)的請(qǐng)求也重定向到鏡像。由于鏡像通常不會(huì)同步私有倉(cāng)庫(kù)的依賴(lài)，這也會(huì)導(dǎo)致私有依賴(lài)無(wú)法下載。

為什么配置為 central 就可以正常工作？

當(dāng)你將 設(shè)置為 central 時(shí)，鏡像只會(huì)代理中央倉(cāng)庫(kù)的請(qǐng)求，而其他倉(cāng)庫(kù)（比如公司私有倉(cāng)庫(kù)）仍會(huì)直接訪問(wèn)原始地址。這樣配置的優(yōu)點(diǎn)是：

• 中央倉(cāng)庫(kù)的請(qǐng)求通過(guò)鏡像加速，避免了外網(wǎng)訪問(wèn)的瓶頸。
• 公司私有倉(cāng)庫(kù)的請(qǐng)求不會(huì)被鏡像覆蓋，Maven 可以直接從私有倉(cāng)庫(kù)下載依賴(lài)。
• 如果鏡像中缺少某些中央倉(cāng)庫(kù)的依賴(lài)，Maven 不會(huì)完全失敗，因?yàn)樗接袀}(cāng)庫(kù)和其他倉(cāng)庫(kù)的請(qǐng)求仍然正常。

<mirror><id>aliyun</id><name>Aliyun Mirror</name><url>https://maven.aliyun.com/repository/public</url><mirrorOf>central</mirrorOf>
</mirror>

這種配置明確指定只代理中央倉(cāng)庫(kù)（ID 為 central 的倉(cāng)庫(kù)），其他倉(cāng)庫(kù)保持原樣。

解決方案

為了解決鏡像配置導(dǎo)致的依賴(lài)下載問(wèn)題，可以采取以下幾種方案：

1. 精確配置鏡像，僅代理中央倉(cāng)庫(kù)
   將 設(shè)置為 central，只讓鏡像代理中央倉(cāng)庫(kù)的請(qǐng)求。這樣可以加速中央倉(cāng)庫(kù)的下載，同時(shí)保留對(duì)公司私有倉(cāng)庫(kù)的直接訪問(wèn)。

<mirrors><mirror><id>aliyun</id><name>Aliyun Mirror</name><url>https://maven.aliyun.com/repository/public</url><mirrorOf>central</mirrorOf></mirror>
</mirrors>

在 pom.xml 或 settings.xml 中，確保公司私有倉(cāng)庫(kù)的配置正確，例如：

<repositories><repository><id>company-repo</id><url>http://nexus.company.com/repository/maven-public/</url></repository>
</repositories>

2. 配置多個(gè)鏡像，分別處理不同倉(cāng)庫(kù)
   如果你的項(xiàng)目需要訪問(wèn)多個(gè)倉(cāng)庫(kù)，可以為每個(gè)倉(cāng)庫(kù)配置獨(dú)立的鏡像。例如，為中央倉(cāng)庫(kù)配置阿里云鏡像，為公司私有倉(cāng)庫(kù)配置內(nèi)部代理：

<mirrors><mirror><id>aliyun</id><name>Aliyun Mirror</name><url>https://maven.aliyun.com/repository/public</url><mirrorOf>central</mirrorOf></mirror><mirror><id>company-mirror</id><name>Company Mirror</name><url>http://nexus.company.com/repository/maven-public/</url><mirrorOf>company-repo</mirrorOf></mirror>
</mirrors>

3. 禁用鏡像，優(yōu)先使用私有倉(cāng)庫(kù)
   如果鏡像的同步問(wèn)題頻繁發(fā)生，可以考慮禁用鏡像，直接使用公司私有倉(cāng)庫(kù)（通常會(huì)代理中央倉(cāng)庫(kù)）。在 settings.xml 中移除或注釋掉 配置，并在 pom.xml 中添加私有倉(cāng)庫(kù)：

<repositories><repository><id>company-repo</id><url>http://nexus.company.com/repository/maven-public/</url></repository>
</repositories>

公司私有倉(cāng)庫(kù)通常會(huì)配置為代理中央倉(cāng)庫(kù)，因此大多數(shù)依賴(lài)都可以通過(guò)私有倉(cāng)庫(kù)獲取。
4. 檢查鏡像的可用性
確保使用的鏡像地址有效且同步正常。例如，訪問(wèn)鏡像的 URL（如 https://maven.aliyun.com/repository/public），檢查是否能正常加載。如果鏡像不可用，可以更換其他鏡像（如華為云或騰訊云）。
5. 使用 Maven 的 --no-mirror 參數(shù)
在調(diào)試時(shí)，可以通過(guò)命令行參數(shù)臨時(shí)禁用鏡像，強(qiáng)制 Maven 直接訪問(wèn)原始倉(cāng)庫(kù)：

mvn install -U --no-mirror

這可以幫助你確認(rèn)問(wèn)題是否由鏡像引起。

總結(jié)

在 Maven 項(xiàng)目中，配置鏡像可以顯著提升依賴(lài)下載速度，但不當(dāng)?shù)呐渲?#xff08;尤其是 *）可能導(dǎo)致依賴(lài)無(wú)法下載。問(wèn)題的核心在于鏡像的同步不完整以及對(duì)私有倉(cāng)庫(kù)的意外覆蓋。通過(guò)將 設(shè)置為 central，可以有效解決這一問(wèn)題，同時(shí)保留對(duì)私有倉(cāng)庫(kù)的訪問(wèn)。此外，合理配置多個(gè)鏡像、檢查鏡像可用性或優(yōu)先使用私有倉(cāng)庫(kù)也是可行的解決方案。