settings.xml中mirror未生效的主因是Maven未加载该配置文件，需确认实际加载路径并检查mirrorOf值是否匹配仓库ID；推荐mirrorOf设为central并手动添加其他仓库，避免用*引发冲突。
settings.xml 里 mirror 配置为什么没生效？
Maven 不读你改的 ~/.m2/settings.xml，除非它真被用了。常见错误是只改了用户目录下的文件，但项目里存在 pom.xml 中的 <repositories></repositories>，或者 IDE（比如 IntelliJ）默认用内置 Maven，压根没加载你的配置。
- 确认 Maven 实际加载的配置路径：运行
mvn -X clean compile 2>&1 | grep "Reading settings from"，看输出里是不是你改的那个settings.xml -
<mirror></mirror>只对<repository></repository>生效，对<pluginrepository></pluginrepository>默认无效，得加<mirrorof>*</mirrorof>或显式配<mirrorof>plugin-repositories</mirrorof> -
<mirrorof>*</mirrorof>能覆盖所有仓库，但会绕过中央仓库的 checksum 校验逻辑，某些企业私仓或安全策略强的环境会拒绝这种镜像请求
阿里云、清华、华为镜像源怎么选？mirrorOf 值怎么填才不翻车？
三个主流镜像源地址本身没问题，但 mirrorOf 写法决定它们是否真接管依赖下载。写成 * 最省事，但可能和私有仓库冲突；写成 central 最安全，但只代理中央仓库，漏掉 Spring、JBoss 等第三方源。
- 阿里云推荐用：
<mirrorof>central</mirrorof>，配合手动加其他常用仓库（如 Spring 的<a href="https://www.php.cn/link/ec18f50d1daf3212ea3b33e7f884ce12">https://www.php.cn/link/ec18f50d1daf3212ea3b33e7f884ce12</a>） - 清华源支持
<mirrorof>*,!repo-id-to-exclude</mirrorof>语法，可排除特定仓库，但 Maven 3.8.1+ 才稳定支持，老版本直接报错 - 华为源对
snapshot仓库支持较弱，如果项目依赖快照版（含-SNAPSHOT），建议单独配<repository></repository>而非走镜像
Maven 3.8.1+ 启用 HTTPS 强制后，镜像源证书报错怎么办？
Maven 3.8.1 默认禁用 HTTP 仓库，而部分镜像站（尤其内网自建 Nexus）仍用 HTTP，或证书链不完整，导致 PKIX path building failed 错误。
- 检查镜像地址是否以
https://开头，不是就换源（比如把<a href="https://www.php.cn/link/79a60ddd18a394faebab43aa57bc83e8">https://www.php.cn/link/79a60ddd18a394faebab43aa57bc83e8</a>改成<a href="https://www.php.cn/link/01fa234d87b812e8c2fb16dc38b52dfa">https://www.php.cn/link/01fa234d87b812e8c2fb16dc38b52dfa</a>） - 如果必须用自签名证书的内网源，别改
JAVA_HOME/jre/lib/security/cacerts，而是用-Dmaven.wagon.http.ssl.insecure=true启动参数临时跳过校验（仅限开发环境） - 更稳妥的做法是在
settings.xml的<server></server>段里配<configuration><sslconfig><truststore></truststore></sslconfig></configuration>，指向你自己的 truststore 文件
IDEA 里 Maven 配置生效但命令行不生效，或者反过来？
IDEA 默认用自己的 Maven 实例（捆绑版），和系统 PATH 里的不是同一个；命令行跑的是系统 Maven，但可能读的是 IDEA 自动生成的临时 settings.xml（带一堆插件仓库）。
立即学习“Java免费学习笔记（深入）”；
- 在 IDEA 中：File → Settings → Build → Build Tools → Maven → User settings file，确认勾选了 “Override” 并指向你手写的
settings.xml - 在命令行中：确保没设置
MAVEN_OPTS="-Dmaven.settings=/path/to/other/settings.xml"这类环境变量干扰 - 一个快速验证法：在项目根目录执行
mvn help:effective-settings，看输出里<mirrors></mirrors>是否包含你配的项，且<activeprofiles></activeprofiles>里没有冲突 profile
Maven 镜像代理这事，核心就两件事：让对的 settings.xml 被对的 Maven 进程加载，再确保 <mirrorof></mirrorof> 的范围既够用又不越界。细节全在路径、版本、协议和工具链的咬合点上，差一点就静默失效。
