Maven 國內鏡像配置指南：阿里雲/騰訊雲/華為雲加速依賴下載

痛點背景

Maven 默認從中央倉庫（repo.maven.apache.org）下載 JAR 包，國內網絡環境下極慢且不穩定。OSChina 鏡像已停維，需切換至活躍的大廠鏡像。

一鍵配置：修改 settings.xml

路徑：${MAVEN_HOME}/conf/settings.xml 或 ~/.m2/settings.xml

<mirrors>
  <!-- 阿里雲（推薦，同步最快、穩定） -->
  <mirror>
    <id>alimaven</id>
    <name>aliyun maven</name>
    <url>https://maven.aliyun.com/repository/public</url>
    <mirrorOf>central</mirrorOf>
  </mirror>

  <!-- 備選：騰訊雲 -->
  <mirror>
    <id>tencent</id>
    <name>tencent maven</name>
    <url>https://mirrors.cloud.tencent.com/nexus/repository/maven-public/</url>
    <mirrorOf>central</mirrorOf>
  </mirror>

  <!-- 備選：華為雲 -->
  <mirror>
    <id>huawei</id>
    <name>huawei maven</name>
    <url>https://repo.huaweicloud.com/repository/maven/</url>
    <mirrorOf>central</mirrorOf>
  </mirror>
</mirrors>

驗證生效

mvn help:effective-settings | grep -A 5 "<mirrors>"
# 或執行任意構建觀察下載地址
mvn clean compile -U

進階：Profile 隔離環境

<profiles>
  <profile>
    <id>nexus</id>
    <repositories>
      <repository>
        <id>central</id>
        <url>https://internal-nexus:8081/repository/maven-public/</url>
        <releases><enabled>true</enabled></releases>
        <snapshots><enabled>true</enabled></snapshots>
      </repository>
    </repositories>
  </profile>
</profiles>
<activeProfiles><activeProfile>nexus</activeProfile></activeProfiles>

常見問題

• HTTPS 證書報錯：JDK 版本過低，升級至 8u161+ 或配置信任存儲
• 私服代理失效：檢查 mirrorOf 是否包含 *,!internal-repo
• SNAPSHOT 不更新：添加 -U 強制檢查或配置 updatePolicy