Maven通过settings.xml中配置将central请求转发至国内私服，核心是客户端重定向而非复制仓库；需确保私服已代理中央仓库（URL为https://repo.maven.apache.org/maven2/），并验证mirrorOf=central及URL正确性。
在 Maven 中，通过 settings.xml 文件，让所有对 central 的请求自动转发到你指定的私服地址。关键不是“把中央仓库复制到私服”，而是“让 Maven 客户端把原本发给 central 的请求，改发给你的私服”——私服再按需代理、缓存和返回依赖。
确认私服已正确代理中央仓库
私服本身必须已配置为远程仓库代理（Proxy Repository），上游 URL 指向 https://repo.maven.apache.org/maven2/（或使用 HTTPS 的官方中央仓库地址）。这是前提：如果私服没连上 central，镜像再快也拉不到依赖。
- Nexus：创建 Proxy 类型仓库，Remote Storage Location 填中央仓库地址，启用 “Auto blocking of remote repository” 和 “Download Remote Indexes”
- 阿里云镜像（无需自建私服）：直接用
https://maven.aliyun.com/repository/public作为 mirror 地址即可 - 检查方式：在私服 Web 界面浏览该 proxy 仓库，应能列出
org/apache/maven/等路径；或 curl 测试：curl -I https://your-nexus-host/repository/maven-public/org/apache/maven/maven-model/3.9.0/maven-model-3.9.0.pom
在 settings.xml 中配置 mirror 覆盖 central
编辑用户级 ~/.m2/settings.xml（推荐）或全局 $MAVEN_HOME/conf/settings.xml，在
<mirror><id>nexus-public</id><mirrorof>central</mirrorof><url>https://your-nexus-host/repository/maven-public/</url><layout>default</layout></mirror>
-
central central的仓库请求（Maven 默认定义的中央仓库 ID） - 若想同时覆盖其他默认仓库（如
spring-plugins），可写成*,!some-repo-id -
repository中已存在的 ID 冲突；后续调试可通过mvn -X查看实际使用的 mirror ID
避免 settings.xml 与 pom.xml 冲突
Maven 解析仓库顺序是：pom.xml → 用户 settings.xml → 全局 settings.xml。如果项目 pom 中硬编码了
- 检查项目 pom 是否含类似片段，若有，建议删除或改为非
central的 ID（如my-central-proxy） - 若必须保留自定义仓库，可在 mirror 中用
external:* central,public - 验证是否生效：执行
mvn help:effective-pom，查看
验证与排错要点
配置完成后，首次构建会触发下载，观察日志和网络行为最直观。
- 运行
mvn clean compile -U（-U强制更新快照），看下载 URL 是否变成私服地址（如Downloading from nexus-public: https://.../junit/junit/4.13.2/junit-4.13.2.jar） - 若仍访问 repo.maven.apache.org，检查：
settings.xml路径是否正确、 - 私服返回 404？说明该依赖未被缓存，私服正尝试从中央仓库拉取——等待几秒重试，或手动触发同步；返回 502/504？检查私服代理配置或网络连通性
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
