Spring Boot 项目依赖下载慢或失败，根本原因是 Maven 默认连接境外中央仓库受网络限制；解决关键是配置国内阿里云镜像源到 settings.xml 并确保 IDEA 正确加载该配置，必要时补充 Spring 官方仓库并清理本地缓存。
Spring Boot 项目创建时依赖下载慢或失败，核心原因是 Maven 默认连接境外中央仓库（https://repo.maven.apache.org/maven2），受网络延迟、DNS 解析不稳定及防火墙策略影响，尤其在首次构建或引入大量 Starter 时极易卡在 “Resolving dependencies” 状态。解决的关键不是反复刷新或换网络，而是精准配置国内可信镜像源，并确保配置生效路径正确。
全局配置 Maven 镜像（最推荐）
一劳永逸，对所有 Maven 项目生效，无需修改每个 pom.xml：
- 找到本地 Maven 的 settings.xml 文件（Windows：`%USERPROFILE%\.m2\settings.xml`；macOS/Linux：`~/.m2/settings.xml`；若不存在可新建）
- 在 `
` 标签内添加阿里云镜像（同步实时、兼容性最强）：
<id>aliyunmaven</id>
<mirrorOf>central</mirrorOf>
<name>Aliyun Maven</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
- 重启 IDEA 或点击右下角 Maven 面板中的 Reload project，无需重启 IDE
IDEA 内置 Maven 设置强制生效
当使用 IDEA 自带的 Maven 或本地 Maven 路径不一致时，需手动绑定配置文件：
- 进入 File → Settings → Build, Execution, Deployment → Build Tools → Maven
- 确认 Maven home path 指向你安装的 Maven 目录（非 bundled）
- 将 User settings file 明确指向已编辑好的 `settings.xml` 路径
- 勾选 Override，确保 IDEA 严格读取该配置
项目级临时补充（针对 Spring 官方组件）
部分 Spring Boot 特定依赖（如 milestone/beta 版本、Spring AI 等）不在公共镜像中，需额外声明仓库：
- 在项目 pom.xml 的 `
` 中追加：
<id>spring-milestones</id>
<name>Spring Milestones</name>
<url>https://repo.spring.io/milestone</url>
</repository>
- 注意：不要同时在 settings.xml 中设置 `
* `，否则会屏蔽此配置；建议用 `central ` 或 `central,!spring-milestones ` 排除例外
辅助排查与清理手段
配置生效后仍失败？大概率是缓存或残留干扰：
- 执行 Maven → Reload project，观察控制台是否出现下载日志（而非一直静默）
- 若报错
Could not transfer artifact，尝试在 IDEA 中执行 mvn clean install -U（-U强制更新远程元数据） - 删除本地仓库中对应失败模块（如 `~/.m2/repository/org/springframework/boot/` 下的子目录），再刷新
- 检查是否误启了系统代理或 IDEA 自带 HTTP 代理（Settings → Appearance & Behavior → System Settings → HTTP Proxy），关闭后重试
