Maven加速：国内镜像源配置全攻略

在 Maven 中配置阿里云镜像（或其他国内镜像源）可以显著加快依赖下载速度，尤其是在国内网络环境下。以下是详细的配置方法，包括多镜像源配置和优先级管理：

1. 单个镜像配置（推荐阿里云）

在 settings.xml（通常位于 ~/.m2/settings.xml 或 %M2_HOME%/conf/settings.xml）中添加阿里云镜像：

<settings>
  <mirrors>
    <!-- 阿里云镜像（默认推荐） -->
    <mirror>
      <id>aliyunmaven</id>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>central,jcenter,!repo1,!sonatype,!jitpack</mirrorOf>
    </mirror>
  </mirrors>
</settings>

关键参数说明：

• mirrorOf 控制镜像覆盖范围：
  • central：覆盖 Maven 中央仓库
  • *：覆盖所有仓库（慎用，可能影响私有仓库）
  • !repo1：排除特定仓库（如 repo1）

2. 多镜像源配置（按需切换）

如果需要多个镜像源（如阿里云 + 华为云），可通过 profile 实现灵活切换：

<settings>
  <profiles>
    <!-- 阿里云配置 -->
    <profile>
      <id>aliyun</id>
      <repositories>
        <repository>
          <id>aliyun-public</id>
          <url>https://maven.aliyun.com/repository/public</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>false</enabled></snapshots>
        </repository>
      </repositories>
    </profile>

    <!-- 华为云配置 -->
    <profile>
      <id>huaweicloud</id>
      <repositories>
        <repository>
          <id>huaweicloud-public</id>
          <url>https://repo.huaweicloud.com/repository/maven/</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>false</enabled></snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>

  <!-- 激活阿里云为默认镜像 -->
  <activeProfiles>
    <activeProfile>aliyun</activeProfile>
  </activeProfiles>
</settings>

切换镜像源：

# 使用华为云镜像
mvn clean install -P huaweicloud

# 使用阿里云镜像（默认）
mvn clean install

3. 私有仓库与镜像共存

如果同时使用私有仓库（如 Nexus），需排除镜像覆盖：

<mirror>
  <id>aliyunmaven</id>
  <url>https://maven.aliyun.com/repository/public</url>
  <mirrorOf>central,jcenter,!internal-repo</mirrorOf>
</mirror>

在 pom.xml 中定义私有仓库：

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

4. 常见问题解决

问题1：镜像不生效

• 检查 settings.xml 文件路径是否正确。
• 运行 mvn help:effective-settings 查看最终生效配置。

问题2：依赖下载失败

• 确认镜像地址可访问（如 curl https://maven.aliyun.com/repository/public）。
• 清理本地缓存：mvn dependency:purge-local-repository。

问题3：SSL证书错误

在 settings.xml 中禁用 SSL 验证（仅限测试环境）：

<server>
  <id>aliyunmaven</id>
  <configuration>
    <allowInsecureProtocol>true</allowInsecureProtocol>
  </configuration>
</server>

5. 国内常用镜像源列表

最佳实践建议

1. 优先使用阿里云镜像（同步频率高，稳定性好）。
2. 生产环境锁定镜像源：通过 mirrorOf 精确控制覆盖范围。
3. 定期更新本地缓存：mvn dependency:purge-local-repository -U。
4. 私有仓库配置：将内部依赖与公共镜像分离，避免冲突。

通过以上配置，可以显著提升 Maven 在国内环境下的构建效率。