Maven 默认下载慢是因为官方中央仓库位于海外,国内直连存在DNS解析慢、TCP超时等问题;推荐配置阿里云镜像https://maven.aliyun.com/repository/public,在settings.xml的中添加对应,需设为central或*,并确保IDE未忽略该配置。

为什么 Maven 默认下载慢
因为 Maven 官方中央仓库 https://repo.maven.apache.org/maven2/ 位于海外,国内直连常遇到 DNS 解析慢、TCP 连接超时、下载中断等问题。不是 Maven 本身有问题,而是网络链路导致的延迟和丢包。
如何配置阿里云 Maven 镜像(推荐)
修改 Maven 的全局或用户级配置文件 settings.xml,在 标签内添加镜像声明。注意:不要删掉原有 ,而是追加一个优先级更高的镜像。
- 文件路径:Maven 安装目录下的
conf/settings.xml(全局),或用户目录下的~/.m2/settings.xml(推荐,避免影响其他用户) - 必须确保
值为central或*,否则镜像不生效 - 阿里云镜像地址是
https://maven.aliyun.com/repository/public,支持 HTTPS 和 HTTP/2
aliyunmaven central Aliyun Maven https://maven.aliyun.com/repository/public
配置后仍下载失败的常见原因
镜像配置正确但依赖还是拉不下来,大概率不是镜像问题,而是以下几种情况:
-
settings.xml文件被 IDE(如 IntelliJ IDEA)忽略:IDEA 默认使用自带的 Maven,需在Settings → Build → Build Tools → Maven中手动指定User settings file - 项目中存在
profiles激活了其他仓库,覆盖了镜像设置;检查和对应内是否定义了 - 公司内网有代理或安全设备拦截了
maven.aliyun.com,可临时用curl -I https://maven.aliyun.com测试连通性 - 本地
~/.m2/repository中已有损坏的元数据(如空的_remote.repositories或不完整的maven-metadata.xml),建议删除对应依赖目录后重试
其他可用镜像及注意事项
除阿里云外,清华、华为、腾讯也提供公开镜像,但稳定性与同步延迟略有差异:
立即学习“Java免费学习笔记(深入)”;
- 清华大学:
https://mirrors.tuna.tsinghua.edu.cn/maven/—— 同步频率高,但偶尔因流量限速触发 503 - 华为云:
https://repo.huaweicloud.com/repository/maven/—— 对华为云账号无绑定要求,但部分旧版本插件索引更新略滞后 - 腾讯云:
https://mirrors.cloud.tencent.com/nexus/repository/maven-public/—— 需注意其 URL 路径含nexus,不是标准 Maven 仓库结构,某些构建工具可能识别异常
所有镜像都只缓存 central 仓库内容,不会代理 JCenter、Spring Plugins 等第三方仓库——如果项目依赖这些源,仍需单独配置 。










