maven通过settings.xml中配置将central请求转发至国内私服，核心是客户端重定向而非复制仓库；需确保私服已代理中央仓库（url为https://repo.maven.apache.org/maven2/），并验证mirrorof=central及url正确性。
在 Maven 中，通过 <mirror></mirror> 配置将中央仓库（Maven Central）镜像到国内私服（如 Nexus、Artifactory 或阿里云、华为云等公开镜像），核心是修改 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，在 <mirrors></mirrors> 标签下添加 mirror 配置：
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
<mirror><id>nexus-public</id><mirrorof>central</mirrorof><url>https://your-nexus-host/repository/maven-public/</url><layout>default</layout></mirror>
-
<mirrorof>central</mirrorof>表示只拦截 ID 为central的仓库请求（Maven 默认定义的中央仓库 ID） - 若想同时覆盖其他默认仓库（如
spring-plugins），可写成<mirrorof>*,!some-repo-id</mirrorof>（高级用法，慎用） -
<id></id>必须唯一，且不能与repository中已存在的 ID 冲突；后续调试可通过mvn -X查看实际使用的 mirror ID
避免 settings.xml 与 pom.xml 冲突
Maven 解析仓库顺序是：pom.xml → 用户 settings.xml → 全局 settings.xml。如果项目 pom 中硬编码了 <repository></repository>（尤其是 ID = central），会覆盖 mirror 设置。
- 检查项目 pom 是否含类似片段，若有，建议删除或改为非
central的 ID（如my-central-proxy） - 若必须保留自定义仓库，可在 mirror 中用
<mirrorof>external:*</mirrorof>或更精确匹配（如<mirrorof>central,public</mirrorof>） - 验证是否生效：执行
mvn help:effective-pom，查看<repositories></repositories>下的 URL 是否已被替换为你配置的私服地址
验证与排错要点
配置完成后，首次构建会触发下载，观察日志和网络行为最直观。
- 运行
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路径是否正确、<mirrors></mirrors>是否在<settings></settings>根节点下、XML 格式是否合法（无注释错误、标签闭合） - 私服返回 404？说明该依赖未被缓存，私服正尝试从中央仓库拉取——等待几秒重试，或手动触发同步；返回 502/504？检查私服代理配置或网络连通性
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
