☕

Maven 镜像配置完全指南

📅 发布时间：2025-12-06 🏷️ 标签：Java, Maven ⏱️ 阅读时间：约 10 分钟

📖 前言

Maven 是 Java 项目的构建和依赖管理工具。从 Maven 中央仓库下载依赖时，国内访问速度较慢。通过配置国内镜像源，可以大幅提升 mvn install 和 mvn package 的速度。

🚀 快速配置（推荐）

使用我们的一键配置脚本：

curl -sSL https://mirror2030.com/install.sh | bash

脚本会自动配置 Maven 镜像源，同时创建配置备份。

🛠️ 手动配置方法

方法一：修改 settings.xml（推荐）

Maven 的配置文件 settings.xml 位于：

用户级配置（推荐）：

# Windows
C:\Users\你的用户名\.m2\settings.xml

# macOS / Linux
~/.m2/settings.xml

全局配置：

# Maven 安装目录下
{MAVEN_HOME}/conf/settings.xml

如果文件不存在，需要手动创建。在 settings.xml 中添加镜像配置：

完整配置示例（阿里云镜像）

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
          http://maven.apache.org/xsd/settings-1.0.0.xsd">

    <mirrors>
        <mirror>
            <id>aliyun-maven</id>
            <name>阿里云公共仓库</name>
            <url>https://maven.aliyun.com/repository/public</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
    </mirrors>

</settings>

其他镜像源配置

腾讯云镜像：

<mirror>
    <id>tencent-maven</id>
    <name>腾讯云公共仓库</name>
    <url>https://mirrors.cloud.tencent.com/nexus/repository/maven-public/</url>
    <mirrorOf>central</mirrorOf>
</mirror>

华为云镜像：

<mirror>
    <id>huawei-maven</id>
    <name>华为云公共仓库</name>
    <url>https://mirrors.huaweicloud.com/repository/maven/</url>
    <mirrorOf>central</mirrorOf>
</mirror>

✅ 验证配置
创建或进入一个 Maven 项目，执行：

mvn dependency:resolve

观察下载速度，如果明显加快说明配置成功。

方法二：项目级配置

如果不想修改全局配置，可以在项目的 pom.xml 中配置：

<project>
    ...
    <repositories>
        <repository>
            <id>aliyun-maven</id>
            <name>阿里云公共仓库</name>
            <url>https://maven.aliyun.com/repository/public</url>
        </repository>
    </repositories>

    <pluginRepositories>
        <pluginRepository>
            <id>aliyun-maven</id>
            <name>阿里云公共仓库</name>
            <url>https://maven.aliyun.com/repository/public</url>
        </pluginRepository>
    </pluginRepositories>
</project>

💡 说明
repositories 用于依赖下载，pluginRepositories 用于 Maven 插件下载。

📊 不同镜像源对比

镜像源	URL	特点
阿里云	https://maven.aliyun.com/repository/public	速度快，稳定性好
腾讯云	https://mirrors.cloud.tencent.com/nexus/repository/maven-public/	企业级稳定
华为云	https://mirrors.huaweicloud.com/repository/maven/	国内大厂支持

❓ 常见问题

Q: 配置后下载仍然很慢？

A: 可能的原因和解决方法：

检查配置文件路径是否正确
检查 XML 格式是否正确（标签闭合、拼写等）
清除本地仓库缓存：删除 ~/.m2/repository 目录
尝试更换其他镜像源

Q: mirrorOf 的值怎么设置？

A: 常用配置：

central - 仅镜像中央仓库
* - 镜像所有仓库
*,!repo-id - 镜像所有仓库，排除 repo-id

Q: 如何同时使用公司私服和公共镜像？

A: 配置多个 mirror，按顺序尝试：

<mirrors>
    <!-- 公司私服 -->
    <mirror>
        <id>company-repo</id>
        <url>http://repo.company.com/maven</url>
        <mirrorOf>*</mirrorOf>
    </mirror>
</mirrors>

Q: 配置后某些依赖找不到？

A: 可能原因：

镜像源同步延迟（等待几小时后重试）
依赖来自特殊仓库（如 Spring Milestone），需单独配置
临时切换回官方源下载该依赖

🔐 安全建议

💡 提示

建议使用知名大厂的镜像源
修改配置前备份原始文件
企业项目建议使用公司私服
定期检查镜像源的可用性

🎓 进阶技巧

1. 配置多仓库组合

阿里云提供多个专用仓库：

<mirrors>
    <!-- 阿里云公共仓库 -->
    <mirror>
        <id>aliyun-public</id>
        <url>https://maven.aliyun.com/repository/public</url>
        <mirrorOf>central</mirrorOf>
    </mirror>

    <!-- 阿里云 Google 仓库 -->
    <mirror>
        <id>aliyun-google</id>
        <url>https://maven.aliyun.com/repository/google</url>
        <mirrorOf>google</mirrorOf>
    </mirror>

    <!-- 阿里云 Spring 仓库 -->
    <mirror>
        <id>aliyun-spring</id>
        <url>https://maven.aliyun.com/repository/spring</url>
        <mirrorOf>spring</mirrorOf>
    </mirror>
</mirrors>

2. 配置认证信息

如果使用需要认证的私服：

<servers>
    <server>
        <id>company-repo</id>
        <username>your-username</username>
        <password>your-password</password>
    </server>
</servers>

3. 查看实际使用的仓库

查看 Maven 使用的仓库列表：

mvn dependency:tree

4. 清除本地缓存

删除本地仓库重新下载：

# Windows
rmdir /s /q %USERPROFILE%\.m2\repository

# macOS / Linux
rm -rf ~/.m2/repository

🔗 相关资源

📞 需要帮助？

如果你在配置过程中遇到问题，可以：

访问我们的 GitHub Issues 提问
发送邮件至：17395905781@163.com
加入我们的社区讨论

最后更新：2025-12-06 | 返回教程列表