IDEA 默认使用自带 Maven 不读取 ~/.m2/settings.xml，需手动配置 Maven home 和 User settings file 并重新加载项目；镜像必须置于 内且 精准匹配 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 里镜像配置写错位置或格式就白改

镜像必须放在 标签内，且 的值要精准匹配中央仓库标识。常见错误包括：写进 、漏掉 、用了 * 导致插件跳过认证。

正确写法（直接贴进 内）：

<mirror><id>aliyunmaven</id><mirrorof>central</mirrorof><name>Aliyun Maven</name><url>https://maven.aliyun.com/repository/public</url></mirror>

注意：

• 用 https 而不是 http（部分网络环境会拦截 http 请求）
• central 表示只代理 id 为 central 的仓库请求，最稳妥；不要写 *
• 如果公司私有仓库也叫 central，得改成 !my-nexus,central 来排除它

改完不生效？先清缓存再验证日志

IDEA 和 Maven 都会缓存元数据和失败标记，光改配置不清理，很可能继续走旧路径。

Idea Spark

根据用户提供的领域或兴趣生成项目创意。当用户询问项目想法、寻求灵感、说“应该做什么项目”或“给我点想法”等时使用。

下载

执行以下三步：

• 删掉项目下的 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，这些不会被 central 覆盖。

查 pom.xml 或父 POM 中的 块，如果有非 central 的仓库，要么：

• 把它们也配成国内镜像（如 JCenter 已停服，需迁移到 https://maven.aliyun.com/repository/jcenter）
• 或者在 settings.xml 的 里为每个仓库单独加一条 ， 填对应仓库 id
• 更彻底的做法：在 pom.xml 中移除冗余仓库，只留必要源

真正卡住的时候，往往不是 central 慢，而是某个第三方仓库响应超时或返回 404，这种问题单靠换镜像解决不了，得定位具体是哪个依赖、哪个仓库拖慢了整个流程。