改对用户级 settings.xml 并配置阿里云镜像可显著加快依赖下载:在 ~/.m2/settings.xml(macos/linux)或 %userprofile%.m2\settings.xml(windows)的 标签下添加 ,其中 * 且 为 https 地址,最后通过 mvn -x 日志验证是否生效。

改对 settings.xml 就能明显加快依赖下载,关键是把阿里云镜像写进用户级配置文件,并确保匹配规则生效。
优先修改用户级 settings.xml 文件
不要动 Maven 安装目录下的全局配置($M2_HOME/conf/settings.xml),而是编辑当前用户的配置文件:
- macOS / Linux:打开
~/.m2/settings.xml - Windows:打开
%USERPROFILE%\.m2\settings.xml
如果该文件不存在,就新建一个;存在则只在 <mirrors></mirrors> 标签下追加镜像配置,别删或改已有内容。
添加正确的阿里云镜像配置
复制以下 XML 片段,粘贴到 <mirrors></mirrors> 内部(注意闭合标签):
<mirror><id>aliyunmaven</id><mirrorof>*</mirrorof><name>Aliyun Maven</name><url>https://maven.aliyun.com/repository/public</url></mirror>
关键点说明:
-
<mirrorof>*</mirrorof>表示拦截所有仓库请求(包括 central、spring、google 等),最稳妥,避免漏包 -
<id></id>值不能重复,也不能含下划线(如aliyun_maven可能失败),推荐用连字符或纯字母数字 -
<url></url>必须是 HTTPS,旧地址http://maven.aliyun.com/nexus/...已弃用,不可用
验证是否真正生效
光改完不等于就起作用,要通过实际日志确认:
- 运行
mvn -X clean compile,搜索日志中类似Downloading from aliyunmaven:或 URL 含maven.aliyun.com的行 - 也可执行
mvn help:effective-settings,检查输出里<mirrors></mirrors>是否包含刚加的aliyunmaven - IDE(如 IntelliJ)可能缓存旧配置,改完需重启 IDE 或手动点击 “Reload project”
常见失效原因和应对
如果还是走中央仓库(repo.maven.apache.org),大概率是这些原因:
- 路径写错:比如误改了全局 settings.xml,但没配
M2_HOME环境变量,Maven 根本没读它 - 多个 mirror 共存:Maven 按顺序匹配,第一个
<mirrorof></mirrorof>匹配成功的就用,后面的全忽略。把<mirrorof>*</mirrorof>放在<mirrors></mirrors>最上面 - 公司私有仓库冲突:若内部 Nexus ID 是
corp-repo,而镜像只写了<mirrorof>central</mirrorof>,那corp-repo请求仍走外网。此时应保留私有仓库声明,阿里云镜像设为*或external:*
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











