針對 pom.xml 中配置的倉庫（repository）未生效導致依賴下載失敗的問題，結合搜索結果和 Maven 依賴解析機制，以下是分步解決方案：
一、問題原因分析
- 鏡像覆蓋全局請求
若settings.xml中配置了鏡像（mirror）且mirrorOf設置為*，會強制所有倉庫請求走鏡像地址，導致pom.xml中定義的倉庫被忽略。 - 本地緩存污染
之前構建失敗的依賴殘留在本地倉庫（~/.m2），導致 Maven 未重新嘗試下載。 - 倉庫 ID 不匹配
pom.xml中定義的倉庫 ID 與鏡像排除規則不匹配，或未正確聲明releases/snapshots策略。 - 優先級沖突
Maven 倉庫的搜索順序中，settings.xml中的配置（如鏡像、profile）優先級高于pom.xml中的倉庫。
二、解決方案
1. 調整鏡像配置，排除特定倉庫
在 settings.xml 中修改鏡像的 mirrorOf，排除 pom.xml 中定義的倉庫 ID，使其繞過鏡像直接訪問目標倉庫：
<mirror><id>aliyun</id><url>https://maven.aliyun.com/repository/public</url><!-- 排除自定義倉庫 --><mirrorOf>*,!your-repo-id,!cloudera-releases</mirrorOf>
</mirror>
? 關鍵點：
? !your-repo-id 需與 pom.xml 中 <repository><id> 完全匹配。
? 多個倉庫用逗號分隔，如 *,!repo1,!repo2。
2. 清理本地緩存并強制更新
# 清理本地倉庫中未完整下載的依賴
mvn dependency:purge-local-repository# 強制檢查遠程倉庫更新
mvn clean install -U
? 作用：清除殘留文件并繞過本地緩存。
3. 驗證倉庫配置有效性
確保 pom.xml 中倉庫的 URL 可訪問 且 依賴版本存在：
<repositories><repository><id>your-repo-id</id><url>https://example.com/maven-repo</url><!-- 明確啟用 releases/snapshots --><releases><enabled>true</enabled></releases><snapshots><enabled>false</enabled></snapshots></repository>
</repositories>
? 注意：若倉庫需要認證，需在 settings.xml 的 <servers> 中配置賬號密碼。
4. 調整倉庫優先級
在 settings.xml 中通過 <profiles> 顯式定義倉庫并激活，提高其優先級：
<profiles><profile><id>custom-repo</id><repositories><repository><id>your-repo-id</id><url>https://example.com/maven-repo</url></repository></repositories><activation><activeByDefault>true</activeByDefault></activation></profile>
</profiles>
? 效果：settings.xml 中的倉庫配置優先級高于 pom.xml。
5. 手動安裝依賴（終極方案）
若倉庫不可用，可手動下載依賴并安裝到本地倉庫：
mvn install:install-file \-Dfile=example.jar \-DgroupId=com.example \-DartifactId=example \-Dversion=1.0.0 \-Dpackaging=jar
? 適用場景：私有依賴或鏡像完全不可用。
三、驗證與調試
- 查看生效配置
執行以下命令檢查最終生效的倉庫和鏡像規則：mvn help:effective-pom -Dverbose mvn help:effective-settings - 檢查依賴來源
添加-X參數查看詳細下載路徑：
觀察日志中是否出現類似mvn clean install -XDownloading from your-repo-id的提示。
四、預防措施
- 避免鏡像全局覆蓋
始終在mirrorOf中排除自定義倉庫（如*,!repo-id）。 - 定期同步私有倉庫
若使用 Nexus 等私服，確保其定時同步公共倉庫（如 Maven Central）。 - 固定依賴版本
在pom.xml中明確指定依賴版本號，避免因版本漂移導致解析失敗。
通過上述步驟，可解決因鏡像覆蓋、緩存污染或配置錯誤導致的倉庫失效問題。若仍無法解決，建議檢查網絡代理或防火墻設置，確保 Maven 能正常訪問目標倉庫 URL。
