Maven 仓库体系按”本地仓库、中央仓库、其他远程仓库、私服”四层理解就不会乱：本地仓库是本机缓存，中央仓库是默认的公共源，私服是企业内网的统一出入口，其余第三方公共仓库和镜像都属于远程仓库的延伸。Maven 本身只定义了仓库的组织规范，实际存储构件的地址才是各类仓库的实体。搞清每一层的角色，再配上一份可复用的 settings.xml 镜像配置，依赖下载慢、私有包找不到、团队配置不一致这三类高频问题基本都有抓手。下文逐类盘点，每类给配置要点，最后附选型对比表。
本地仓库：所有构建的起点
本地仓库位于开发者机器上，是整个依赖链路的第一站，管理好它能省掉大半排查时间：
- 默认路径在用户目录的 .m2/repository，可用 settings.xml 的 localRepository 标签重定向到大容量磁盘；
- Maven 解析依赖先查这里，命中直接使用，未命中才走远程下载并缓存副本，mvn install 装的项目构件也存在这里；
- 依赖残留导致拉取异常时，用 mvn dependency:purge-local-repository 清理，支持按 groupId:artifactId 精确清除。
国内开发者常见的”.lastUpdated 残留导致依赖拉不下来”，多数就是本地仓库状态异常，删掉对应目录重新构建即可恢复。
中央仓库与镜像：公共依赖的来源
中央仓库由 Maven 社区维护，地址是 repo.maven.apache.org/maven2，绝大多数开源 Java 库都在这里，零配置即为默认远程源。短板在国内网络环境下很明显——跨国链路慢且不稳定，所以实践中都会配镜像。镜像可理解为远程仓库的完整副本，国内主流选择有四类：
- 阿里云公共仓库：maven.aliyun.com/repository/public，聚合中央仓库等多个源，同步及时，访问速度稳定；
- 腾讯云镜像：mirrors.cloud.tencent.com 下的 maven-public 路径，常作为备用源；
- 华为云镜像：repo.huaweicloud.com，同样提供中央仓库代理能力；
- Apache Snapshots 等官方快照仓库：存放开发中的 SNAPSHOT 版本，按需添加。
镜像配置有固定四步，照做即可生效：
- 打开 settings.xml（用户级在 ~/.m2/settings.xml，全局在 Maven 安装目录 conf 下）；
- 在 mirrors 节点加入 mirror 子节点，mirrorOf 决定接管范围；
- 执行 mvn help:effective-settings 确认配置被读取；
- 随便构建一次，观察下载地址是否已切换到镜像。
<mirrors>
<mirror>
<id>aliyunmaven</id>
<mirrorOf>central</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>mirrorOf 写 central 只接管中央仓库请求，写 则接管全部仓库。用 时要小心：它会连公司私服、特定快照仓库的请求一并接管，造成”明明配了仓库却下载不到”的假故障，用 *，!internal 这类排除语法可以规避。配完镜像后发现下载地址没变，按三步定位：
- 确认编辑的是生效的那份 settings.xml，用户级与全局配置并存时容易改错文件；
- 执行 mvn help:effective-settings，在输出里搜索镜像 id，确认配置被读取；
- 检查 mirrorOf 范围与仓库 id 是否匹配，范围写错会静默跳过镜像。
私服：企业内部的依赖枢纽
私服是架设在企业内网的仓库代理软件，对外代理中央仓库与各类公共源，对内托管自研构件。它的价值集中在四点：
- 节省外网带宽：重复依赖只从私服拉一次；
- 加速构建：内网链路下载速度远高于直连公网；
- 统一入口：内部库与外部库走同一地址，权限与审计可管；
- 托管私有包：不便公开的公司内部 jar 有了正式发布渠道。
团队规模超过几个人后，私服基本是必选项。主流方案有三类，选型对比见表：
| 方案 | 定位 | 特点与适用场景 |
|---|---|---|
| Sonatype Nexus | 自建私服的事实标准 | 开源版够用，支持 Maven/npm/PyPI 多格式，社区资料丰富 |
| JFrog Artifactory | 功能全面的自建/商业方案 | 高可用与元数据能力强，适合大型组织 |
| 云效 Packages 等云服务 | 免运维的托管私服 | 开通即用，自带中央仓库代理，适合不想维护服务器的团队 |
接入私服的步骤同样固定：
- 在 Nexus 或 Artifactory 上建好代理仓与宿主仓；
- 把私服地址配成 settings.xml 的镜像或 pom.xml 的 repository；
- 在 servers 节点写入对应的用户名密码，id 与仓库 id 保持一致。
自建与托管怎么选，看团队是否有运维人力和内网隔离要求：有隔离要求选自建，接受 SaaS 形态则托管服务上线更快。
settings.xml 常用配置节点盘点
围绕仓库体系，settings.xml 里真正常用的节点就五个：
- localRepository：指定本地仓库路径；
- mirrors：配置镜像与接管范围；
- servers：存放私服或认证仓库的凭据；
- profiles：按环境组合仓库配置；
- activeProfiles：声明默认激活的 profile。
这五个节点覆盖了九成场景，其余如 offline、proxy 属于特殊环境才用。配置文件改动后记得让 IDE 重新加载 Maven 设置，否则编辑器内构建仍走旧配置。
一次完整的依赖查找顺序
把四层体系串起来，Maven 找一个依赖的路径是：
- 查本地仓库，命中即返回，构建结束；
- 本地未命中，按 settings.xml 与 pom.xml 里配置的镜像与远程仓库发起请求；
- 已配私服时请求先落到私服，有缓存直接返回；
- 私服未命中，由私服代理去中央仓库或公共源拉取，缓存后回传；
- 本地仓库留存副本，下次同版本依赖不再走网络。
顺着这条链路排查，”下载慢”查镜像配置，”找不到”查 mirrorOf 范围与仓库顺序，”版本不对”查私服缓存与 SNAPSHOT 更新策略，思路就清晰了。
常见问题（FAQ）
Q1：Maven 本地仓库默认在哪个目录？
用户目录下的 .m2/repository，可在 settings.xml 用 localRepository 修改。
Q2：settings.xml 放在哪里优先级更高？
用户目录的 ~/.m2/settings.xml 优先于 Maven 安装目录 conf 下的全局配置。
Q3：mirrorOf 写 central 和星号有什么区别？
central 只接管中央仓库请求，* 接管所有仓库，配私服时可用排除语法保护特定仓库。
