镜像失效主因是未匹配目标仓库id，应查pom.xml或构建日志确认真实id；推荐用*或external:*，并确保url完整有效（如https://maven.aliyun.com/repository/public），且需置于根节点下。
settings.xml里mirror标签写不对，依赖还是走中央仓库
镜像配置失效最常见原因是 <mirrorof></mirrorof> 值没匹配上原始仓库 ID。Maven 不是“看到镜像就用”，而是根据这个字段做路由匹配。比如中央仓库默认 ID 是 central，但很多项目在 pom.xml 里自定义了仓库，ID 变成 my-nexus 或 spring-snapshots，这时只配 <mirrorof>central</mirrorof> 就完全无效。
实操建议：
- 先确认目标仓库的真实 ID：查项目根目录下
pom.xml的<repositories></repositories>块，或看构建日志里下载失败时打印的 “Downloading from XXX” 中的 XXX -
<mirrorof></mirrorof>推荐用*（匹配所有）或external:*（匹配所有外网仓库），避免漏配；生产环境若需精确控制，再按 ID 列表写，如central,public,spring-milestones - 镜像
<url></url>必须可直连：用curl -I测试，比如curl -I https://maven.aliyun.com/repository/public，返回 200 才算通
多个mirror同时存在时，谁生效？
Maven 按 settings.xml 中 <mirror></mirror> 出现顺序匹配，**第一个匹配成功的就用它，后面的全忽略**。不是合并、不是 fallback，更不会轮询。
常见错误现象：
立即学习“Java免费学习笔记（深入）”；
- 加了阿里云镜像后，某些 snapshot 依赖还是慢 → 很可能前面有个
<mirrorof>snapshots</mirrorof>指向了一个已下线的私有 Nexus，它先匹配上了，后面阿里云的<mirrorof>*</mirrorof>根本没机会触发 - 公司内部 Nexus 镜像和阿里云镜像共存，但内部仓库 ID 是
corp-repo，而<mirrorof></mirrorof>写成central→ 内部依赖仍走外网
建议把最通用的镜像（如 <mirrorof>*</mirrorof>）放在 <mirrors></mirrors> 块最顶部，其他特殊镜像放下面，并确保它们的 <mirrorof></mirrorof> 值不重叠、不被上面的宽泛规则覆盖。
profile 激活镜像后，命令行 mvn clean install 还是不走镜像
镜像配置写在 <profile></profile> 里，但 profile 默认不激活。即使写了 <activebydefault>true</activebydefault>，Maven 3.9+ 对它的处理也更严格——如果 settings.xml 里有多个 profile，且没有显式激活，它可能被跳过。
验证和修复方式：
- 运行
mvn help:effective-settings，搜<mirrors></mirrors>块，确认最终生效的 settings 是否包含你配的 mirror - 去掉 profile 包裹，把
<mirror></mirror>直接写在<mirrors></mirrors>根节点下 —— 这是最稳的方式，99% 场景不需要 profile 控制镜像 - 真要 profile 分环境（如 dev 用内网镜像、prod 用阿里云），激活必须显式：加
-Pdev参数，或在settings.xml的<activeprofiles></activeprofiles>里声明
镜像 URL 末尾带 /repository/public 和不带的区别
本质是路径层级问题。阿里云、腾讯云等公开镜像站，实际提供服务的路径是 /repository/public（公开库）、/repository/central（中央库镜像）、/repository/spring-plugins 等。如果 URL 少了这部分，Maven 请求会 404，然后退回到原始仓库。
典型错误：
- 复制粘贴时手抖删了
/repository/public，只留https://maven.aliyun.com→ 所有依赖下载失败，日志里出现Failed to transfer ... from/to central - 误用旧版文档地址，比如
http://maven.aliyun.com/nexus/content/groups/public（已停用）→ 返回 503 或空白页
当前推荐 URL（2024 年有效）：
- 阿里云公共库：
https://maven.aliyun.com/repository/public - 腾讯云：
https://mirrors.cloud.tencent.com/nexus/repository/maven-public - 华为云：
https://repo.huaweicloud.com/repository/maven
URL 必须完整、协议必须是 https，少一个字符都可能让整个依赖链卡住。别图省事截短，也别信搜索引擎里过期的博客链接。
