Maven下载依赖包很慢怎么办 Maven镜像地址修改方法【优化】

IDEA中Maven依赖下载卡顿或超时，需手动指定本地Maven安装路径并配置阿里云镜像：在Settings中切换为Use specified installation，指向本地Maven根目录，设置User settings file为~/.m2/settings.xml，重启IDEA后在中添加id为aliyunmaven、mirrorOf为central、url为https://maven.aliyun.com/repository/public的镜像配置，并删除所有.lastUpdated文件及IDEA缓存验证生效。

当你在IDEA里点开Maven面板刷新依赖，进度条卡在Downloading xxx.jar不动，终端日志反复显示“Connection timed out”或下载速度长期低于200KB/s，说明Maven正从国外中央仓库硬扛网络延迟——这不是项目问题，是默认配置没适配国内网络环境。

确认Maven实际读取的配置文件位置

很多人改了~/.m2/settings.xml却没效果，因为IDEA默认用自带Maven（路径类似plugins/maven/lib/maven3），根本不读你用户目录下的配置文件。

打开File → Settings → Build, Execution, Deployment → Build Tools → Maven，检查Maven home path：如果显示Bundled (Maven 3.x)，它就完全忽略你的settings.xml。

必须手动切换为Use specified installation，并指向你本地安装的Maven根目录（如D:\apache-maven-3.9.6）；同时确保User settings file明确填入C:\Users\用户名\.m2\settings.xml（Windows）或~/.m2/settings.xml（Mac/Linux）。

【关键前提】IDEA必须重启后才真正加载新指定的settings.xml，不重启等于白配。

修改settings.xml添加阿里云镜像

方法一：直接编辑用户级配置（推荐）

用文本编辑器打开~/.m2/settings.xml，找到标签（若不存在，就在根节点内手动创建该标签）。

在内部粘贴以下配置：

  aliyunmaven
  central
  Aliyun Maven
  https://maven.aliyun.com/repository/public

【易错点】central不能写成*或**，否则部分插件会跳过认证导致后续构建失败。

方法二：全局配置（适合多用户或CI环境）

进入Maven安装目录conf/settings.xml，同样在中添加上述镜像块。此方式对所有使用该Maven实例的项目生效，无需每个用户单独配置。

清理缓存强制触发新镜像下载

第一步：删除本地仓库中的lastUpdated标记文件

这些文件是Maven的“懒加载锁”，只要存在，Maven就拒绝重试下载——哪怕你刚换完镜像源。

Windows用户可直接运行以下命令（管理员权限CMD）：

for /f "delims=" %i in ('dir /b /s "%USERPROFILE%\.m2\repository\*lastUpdated*"') do del /s/q "%i"

Mac/Linux用户执行：

find ~/.m2/repository -name "*lastUpdated" -delete

第二步：清空IDEA缓存并重载

删掉项目根目录下的target和.idea/libraries目录；然后在IDEA中点击File → Invalidate Caches and Restart → Invalidate and Restart。

第三步：验证是否走新镜像

在项目根目录终端执行：mvn dependency:resolve -Dclassifier= -X | findstr "maven.aliyun"（Windows）或mvn dependency:resolve -Dclassifier= -X | grep "maven.aliyun"（Mac/Linux）。看到URL含maven.aliyun.com即表示生效。