IDEA中Maven依赖下载卡顿或超时，需手动指定本地Maven安装路径并配置阿里云镜像：在Settings中切换为Use specified installation，指向本地Maven根目录，设置User settings file为~/.m2/settings.xml，重启IDEA后在<mirrors>中添加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，找到<mirrors>标签（若不存在，就在<settings>根节点内手动创建该标签）。
在<mirrors>内部粘贴以下配置：
<mirror><br> <id>aliyunmaven</id><br> <mirrorOf>central</mirrorOf><br> <name>Aliyun Maven</name><br> <url>https://maven.aliyun.com/repository/public</url><br></mirror>
【易错点】<mirrorOf>central</mirrorOf>不能写成*或**，否则部分插件会跳过认证导致后续构建失败。
方法二：全局配置（适合多用户或CI环境）
进入Maven安装目录conf/settings.xml，同样在<mirrors>中添加上述镜像块。此方式对所有使用该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即表示生效。
