Maven 配置阿里云镜像加速导包（附国内镜像大全）

在国内使用 Maven 构建 Java 项目时，如果直接访问 Maven Central（中央仓库），经常会遇到下载速度慢、甚至连接超时的问题。
为了提高依赖下载速度，我们可以使用 国内 Maven 镜像，其中最常用且稳定的就是 阿里云 Maven 镜像。

---

1. 找到 settings.xml 文件

Maven 的 settings.xml 配置文件有两个位置：

• 全局配置（影响所有用户）

\$MAVEN\_HOME/conf/settings.xml

• 用户配置（只影响当前用户）

\~/.m2/settings.xml

建议 修改 用户配置，避免影响全局环境。

---

2. 配置阿里云 Maven 镜像

在 settings.xml 中找到 <mirrors> 标签，如果没有就自己加一个，添加以下内容：

<mirrors>
  <!-- 阿里云 Maven 中央仓库镜像 -->
  <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>central</mirrorOf>
      <name>Aliyun Central</name>
      <url>https://maven.aliyun.com/repository/public</url>
  </mirror>
</mirrors>

这样，Maven 中央仓库的请求会自动走阿里云镜像，加速下载。

---

3. 使用阿里云聚合仓库（推荐）

阿里云提供了公共聚合仓库，整合了 Maven Central、JCenter、Google 等多个源：

<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>true</enabled>
                </snapshots>
            </repository>
        </repositories>
    </profile>
</profiles>

<activeProfiles>
    <activeProfile>aliyun</activeProfile>
</activeProfiles>

这样即使依赖不在 Maven Central，也能从阿里云仓库下载。

---

4. 验证是否生效

执行以下命令：

mvn help:effective-settings

如果输出中 <mirrors> 地址为阿里云的 URL，则说明配置成功。

---

5. 国内常用 Maven 镜像源大全

镜像名称	地址	特点
阿里云	https://maven.aliyun.com/repository/public	稳定、速度快、聚合多个仓库
华为云	https://mirrors.huaweicloud.com/repository/maven/	稳定、CDN 加速
腾讯云	https://mirrors.cloud.tencent.com/nexus/repository/maven-public/	稳定、可与腾讯云 DevOps 集成
清华大学	https://mirrors.tuna.tsinghua.edu.cn/maven/	高速、学术网络加速
中科大	https://mirrors.ustc.edu.cn/maven/	稳定、开源社区维护

---

6. 多镜像配置示例（自动回退）

如果你希望同时配置多个国内镜像，提高可用性，可以这样写：

<mirrors>
    <mirror>
        <id>aliyun</id>
        <mirrorOf>central</mirrorOf>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
    <mirror>
        <id>huaweicloud</id>
        <mirrorOf>central</mirrorOf>
        <url>https://mirrors.huaweicloud.com/repository/maven/</url>
    </mirror>
    <mirror>
        <id>tencent</id>
        <mirrorOf>central</mirrorOf>
        <url>https://mirrors.cloud.tencent.com/nexus/repository/maven-public/</url>
    </mirror>
</mirrors>

这样，当一个镜像源不可用时，Maven 会尝试下一个。

---

7. 常见问题

① 配置了镜像但速度依旧慢

• 检查网络环境（如公司内网可能需要代理）。
• 尝试更换其他国内镜像。

② 某些包下载失败

• 可能该依赖不在镜像仓库中，需要额外添加私有仓库地址。

---

总结

在国内开发环境中，配置 阿里云 Maven 镜像 能大幅提升依赖下载速度。 为了最大化可用性，可以结合阿里云、华为云、腾讯云等多个国内镜像，做到高速、稳定、自动回退。

建议在每台开发机的 ~/.m2/settings.xml 中完成此配置，让构建更高效！