IDEA 默认使用自带 Maven 不读取 ~/.m2/settings.xml，需手动配置 Maven home 和 User settings file 并重新加载项目；镜像必须置于 <mirrors> 内且 <mirrorOf> 精准匹配 central；生效前需清理缓存并验证日志。
确认 IDEA 正在使用你改过的 settings.xml
很多人改了 ~/.m2/settings.xml 却没效果，根本原因是 IDEA 默认用的是自带的 Maven（Bundled (Maven 3.x)），它压根不读你用户目录下的配置文件。
必须手动指定：
- 打开
File → Settings → Build, Execution, Deployment → Build Tools → Maven - 把
Maven home path改成Use specified installation，指向你本地安装的 Maven（比如/opt/homebrew/Cellar/maven/3.9.6或C:\Program Files\apache-maven-3.9.6） - 同时确保
User settings file明确指向~/.m2/settings.xml（或你实际编辑的那个路径）
改完别急着点 OK —— 点击右侧的 Reload project 按钮，或者右键项目选 Maven → Reload project，否则 IDEA 不会重新加载配置。
settings.xml 里镜像配置写错位置或格式就白改
镜像必须放在 <mirrors> 标签内，且 <mirrorOf> 的值要精准匹配中央仓库标识。常见错误包括：写进 <profiles>、漏掉 <mirrorOf>、用了 * 导致插件跳过认证。
正确写法（直接贴进 <mirrors> 内）：
<mirror> <id>aliyunmaven</id> <mirrorOf>central</mirrorOf> <name>Aliyun Maven</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>
注意：
- 用
https而不是http（部分网络环境会拦截 http 请求） -
<mirrorOf>central</mirrorOf>表示只代理 id 为central的仓库请求，最稳妥；不要写<mirrorOf>*</mirrorOf> - 如果公司私有仓库也叫
central，得改成<mirrorOf>!my-nexus,central</mirrorOf>来排除它
改完不生效？先清缓存再验证日志
IDEA 和 Maven 都会缓存元数据和失败标记，光改配置不清理，很可能继续走旧路径。
执行以下三步：
- 删掉项目下的
target目录和.idea/libraries目录（强制重解析依赖） - 删掉
~/.m2/repository/.cache/maven-metadata-central.xml及同类文件（清除仓库索引缓存） - 在 IDEA 内置终端运行：
mvn -X dependency:resolve -Dartifact=org.slf4j:slf4j-api:1.7.36，看输出里下载 URL 是否变成maven.aliyun.com
如果日志里还出现 repo.maven.apache.org，说明镜像没生效，回头检查前两步。
为什么有时候还是慢？关键在依赖来源不止 central
阿里云镜像只加速 central 仓库，但你的项目可能还拉 jcenter、spring-milestones 或私有 Nexus，这些不会被 <mirrorOf>central</mirrorOf> 覆盖。
查 pom.xml 或父 POM 中的 <repositories> 块，如果有非 central 的仓库，要么：
- 把它们也配成国内镜像（如 JCenter 已停服，需迁移到
https://maven.aliyun.com/repository/jcenter） - 或者在
settings.xml的<mirrors>里为每个仓库单独加一条<mirror>，<mirrorOf>填对应仓库 id - 更彻底的做法：在
pom.xml中移除冗余仓库，只留必要源
真正卡住的时候，往往不是 central 慢，而是某个第三方仓库响应超时或返回 404，这种问题单靠换镜像解决不了，得定位具体是哪个依赖、哪个仓库拖慢了整个流程。
