settings.xml未生效的主因是配置位置错误或被覆盖：用户级~/.m2/settings.xml优先于全局配置，IDE可能使用独立路径，镜像必须置于根节点，*才匹配所有仓库，URL须为https://maven.aliyun.com/repository/public。
为什么 settings.xml 改了却没生效
常见现象是改完阿里云镜像地址，mvn clean compile 依然走中央仓库、下载慢、甚至报 Connection timed out。根本原因通常是配置位置错了，或者被其他配置覆盖。
-
~/.m2/settings.xml（用户级）优先级高于$M2_HOME/conf/settings.xml（全局），但 Maven 默认不创建用户级文件，很多人直接改了全局文件却没意识到自己用的是用户级配置 - IDE（如 IntelliJ）可能自带内置 Maven 或读取独立的 settings 路径，需在
Settings > Build > Build Tools > Maven中确认「User settings file」指向的是你修改的那个settings.xml - 检查是否有
<mirrors></mirrors>块被写在<profiles></profiles>里——镜像必须放在<mirrors></mirrors>根节点下，放错位置完全无效
阿里云镜像的正确 <mirror></mirror> 配置写法
官方文档给的示例常省略关键细节，比如 <mirrorof></mirrorof> 的值直接影响是否命中。用错会导致部分依赖仍走中央仓库，甚至冲突。
- 推荐写法：
<mirrorof>*</mirrorof>—— 匹配所有仓库，最简单直接；但若项目显式声明了私有仓库（如公司 Nexus），建议改用<mirrorof>central</mirrorof>，避免意外代理非公开源 -
<id></id>必须唯一，且不能含下划线或特殊字符（某些旧版 Maven 会解析失败），建议用aliyunmaven这类纯字母 ID - URL 必须用
https://maven.aliyun.com/repository/public，旧链接http://或/nexus/路径已失效，会返回 404
<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>Aliyun Maven</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>
遇到 Could not transfer artifact 还要查什么
即使镜像配置正确，仍可能卡在某个依赖下载失败。这不是镜像问题，而是阿里云仓库本身不托管所有内容（比如某些 snapshot、第三方私有包、或刚发布的版本尚未同步）。
- 先用
mvn help:effective-settings确认当前生效的 mirror 是否是你配的 ID 和 URL - 用
curl -I https://maven.aliyun.com/repository/public/org/springframework/spring-core/6.1.0/spring-core-6.1.0.pom手动测 URL 是否可访问（注意替换为真实坐标），返回 200 才说明镜像有该包 - 如果返回 404，去 mvnrepository.com 查该依赖的「Repository」字段，确认它原本就不是发在 Central 的（比如来自
spring-milestones），就得单独为那个 repo 配<repository></repository>，不能只靠 mirror
Java 项目里要不要在 pom.xml 写 <repositories></repositories>
一般不要。在 pom.xml 里硬编码仓库地址会覆盖 settings.xml 的 mirror 规则，导致团队协作时本地快、CI 慢，或不同环境行为不一致。
立即学习“Java免费学习笔记（深入）”；
- 例外场景：项目确实依赖某个非 Central 仓库（如 JFrog Artifactory 上的内部 SDK），这时才应在
pom.xml的<repositories></repositories>中声明，并设置<id></id>与settings.xml中对应<server></server>的 ID 一致，用于后续认证 - 永远别在
pom.xml里重复写阿里云镜像——这会让其他开发者无法用自己的镜像策略，也违背 Maven “约定优于配置” 的设计逻辑
settings.xml 到底被谁读、读的是哪一份，得亲手用 mvn help:effective-settings 看一眼才踏实。 
