镜像组配置必须写在settings.xml的节点内，每个为独立条目，通过mirrorOf值匹配和XML顺序实现优先级；不支持逗号分隔或“镜像组”语法。
镜像组配置写在 settings.xml 的哪个位置
镜像组（mirrorOf）必须定义在 <mirrors></mirrors> 节点内，且每个 <mirror></mirror> 是独立条目，Maven 不支持“镜像组”语法——所谓“组”只是靠多个 <mirror></mirror> 共享同一 mirrorOf 值模拟出来的。常见错误是试图用逗号或通配符拼凑多个 ID，比如 mirrorOf="central,public"，这会直接失效。
正确做法是为同一目标仓库（如中央仓）配置多个镜像，靠顺序和匹配规则实现优先级：
-
<mirrorof></mirrorof>值必须是单个字符串，支持通配符（*、external:*、repo1,repo2等），但不支持空格或逗号分隔的列表 - 多个
<mirror></mirror>条目按 XML 中出现顺序从上到下匹配，第一个mirrorOf匹配成功的即被选用，后续条目不再检查 - 因此“优先级”本质就是 XML 书写顺序：越靠前的镜像，匹配权重越高
mirrorOf 的匹配逻辑和常见陷阱
Maven 的镜像匹配不是“找最像的”，而是“找第一个能覆盖目标仓库的”。例如你项目中声明了 <repository></repository> ID 为 aliyun-spring，而你的 mirrorOf 写成 central，那它完全不生效——因为只匹配 ID 为 central 的仓库。
常用且安全的 mirrorOf 值：
-
*：匹配所有仓库（慎用，可能绕过私有仓库） -
external:*：匹配所有非 localhost 的仓库（推荐，兼顾私有仓） -
central：仅匹配 ID 为central的仓库（最稳妥，但需确保项目没改中央仓 ID） -
!nexus-internal,*：排除 ID 为nexus-internal的仓库，其余全匹配（注意感叹号必须紧贴 ID，无空格）
典型错误：mirrorOf="*, !company-nexus" —— Maven 不支持这种写法，会整个匹配失败；正确应为 mirrorOf="!company-nexus,*"，且必须放在所有通用镜像之前。
多个镜像共存时怎么控制 fallback 行为
Maven 本身不提供镜像 fallback（即主镜像挂了自动切备用）。所谓“多镜像源优先级”，其实是靠多个 <mirror></mirror> + 合理的 mirrorOf 组合来模拟的。关键在于：把高可用、低延迟的镜像放前面，把兜底镜像（如官方中央仓）放最后，并用更宽泛的 mirrorOf 覆盖它。
示例结构（按推荐顺序）：
<mirrors>
<mirror>
<id>aliyun-public</id>
<mirrorOf>external:*,!nexus-prod</mirrorOf>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
<mirror>
<id>tencent-central</id>
<mirrorOf>central</mirrorOf>
<url>https://mirrors.cloud.tencent.com/nexus/repository/maven-public/</url>
</mirror>
<mirror>
<id>maven-central</id>
<mirrorOf>*</mirrorOf>
<url>https://repo.maven.apache.org/maven2/</url>
</mirror>
</mirrors>
说明：
- 第一项用
external:*,!nexus-prod覆盖绝大多数外部依赖，同时排除公司生产 Nexus - 第二项专用于
central，作为阿里云镜像的补充（有些老插件仍硬编码 central） - 最后一项
<mirrorof>*</mirrorof>是保底，只有前面全部不匹配时才触发
验证镜像是否生效及调试方法
光看 settings.xml 写对没用，得确认实际下载走的是哪个 URL。最直接的方式是开启 Maven 调试日志：
mvn clean compile -X | grep -i "downloading\|using repository"
你会看到类似这样的输出：
[DEBUG] Using connector BasicRepositoryConnector with priority 0.0 for https://maven.aliyun.com/repository/public
如果发现仍连向 repo.maven.apache.org，重点检查：
- 当前使用的
settings.xml是哪个？Maven 默认读$M2_HOME/conf/settings.xml和$HOME/.m2/settings.xml，后者优先级更高 - 项目
pom.xml是否定义了<repositories></repositories>并显式禁用了镜像（<mirrorof></mirrorof>不匹配时，Maven 会回退到原始仓库） -
mirrorOf值是否大小写敏感？是的，Central≠central
真实环境里最容易被忽略的一点：CI/CD 流水线往往自带一套 settings.xml，本地调通了不等于线上生效。
