Maven 国内镜像配置指南
1. 背景
在 Java 项目开发中,Maven 是最常用的依赖管理工具。由于网络环境限制,直接从 Maven 中央仓库下载依赖时常会遇到速度慢、连接超时等问题。通过配置国内镜像源,可以显著提升依赖下载速度,提高开发效率。
2. 推荐一些国内镜像源
阿里云镜像:https://maven.aliyun.com/repository/public
腾讯云镜像:https://mirrors.cloud.tencent.com/nexus/repository/maven-public/
华为云镜像:https://repo.huaweicloud.com/repository/maven/
3. 具体配置步骤
3.1 全局配置
找到 Maven 安装目录下的 conf/settings.xml 文件,在 <mirrors> 标签内添加以下配置:
<mirrors>
<mirror>
<id>aliyun-maven</id>
<mirrorOf>central</mirrorOf>
<name>阿里云公共仓库</name>
<!-- url这里是阿里云镜像,可以替换成上面提到的其他镜像源 -->
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
打开Maven
里面的 .m2

打开 setting.xml

在如下部分添加

3.2 也可以在你的项目上配置
在项目的 pom.xml 文件中添加以下配置:
<repositories>
<repository>
<id>aliyun-maven</id>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>aliyun-maven</id>
<name>阿里云插件仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</pluginRepository>
</pluginRepositories>
同样的,如果速度慢可以换其他镜像源试试
3.3 在 IDEA 配置
- 打开 IDEA,进入 File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven
- 在 User settings file 中指定你的 settings.xml 文件路径
- 点击 Apply 和 OK 保存配置

3.4 验证配置
在项目根目录执行以下命令,观察下载速度:
mvn clean install



或者在 IDEA 中点击右侧 Maven 面板的刷新按钮重新加载依赖。
这就不贴图了
4. 常见问题
4.1 如果配置后仍然很慢
- 检查 settings.xml 文件是否正确加载
- 确认 <mirrorOf> 配置为 central 或 *
- 清理本地仓库缓存:删除 ~/.m2/repository 目录后重新下载
注意这里用 <mirrorOf>*</mirrorOf> 会拦截所有仓库请求并转到阿里云镜像。
配置后重新运行 mvn clean install 即可。
4.2 有时候部分依赖下载失败
可能是某些私有依赖不在公共镜像中,需要配置额外的仓库地址
实在不行可以配置多个镜像源作为备选
5. 一些注意事项
- 全局配置会影响所有 Maven 项目,比较方便,所以推荐使用此方式
- 项目级配置仅对当前项目生效
- 要定期检查镜像源的可用性,有时候镜像源可能变更,必要时更换备用镜像
因为默认源在国外,国内下载慢到离谱,甚至直接失败。通过配置国内镜像源,可以有效解决 Maven 依赖下载慢的问题。
技术分享~ 持续更新中~
更多推荐



所有评论(0)