如何设置Maven pom.xml中的远程仓库地址？

本文共计855个文字，预计阅读时间需要4分钟。

许多人配置远程仓库时发现没有生效，第一反应通常是地址错了，但实际上更大可能性是放错了位置。Maven通过``标签来定义项目依赖仓库和插件仓库。``必须嵌套在``标签下，否则配置将不会读取。具体代码如下：

• repositories 控制 dependencies 中的 jar 包来源
• pluginRepositories 只影响 build/plugins 里的插件（比如 maven-compiler-plugin）
• 如果只配了 pluginRepositories 却想拉 spring-boot-starter-web，肯定失败

镜像配置（settings.xml）优先级高于 pom.xml 中的 repository

本地 settings.xml 里写了 <mirror></mirror>，哪怕 pom.xml 明确写了阿里云地址，Maven 也会先走镜像。这不是 bug，是设计逻辑：用户级配置 > 项目级配置。

• 调试时先确认 ~/.m2/settings.xml 或 M2_HOME/conf/settings.xml 是否有 <mirrors></mirrors> 块
• 临时绕过镜像：加参数 -Dmaven.repo.local=/tmp/m2 + 清空该目录，避免缓存干扰
• 公司内网私服地址，建议统一配在 settings.xml 的 profiles 里，而不是每个 pom 都写一遍

repository 的 id 不能重复，且不能为 central

id 是仓库的唯一标识，Maven 内部用它做缓存路径和策略匹配。设成 central 会导致覆盖默认中央仓，可能连 junit:junit 都拉不到。

• 常见错误：<id>central</id> —— 直接删掉或改成 aliyun-central、nexus-releases 这类明确含义的名字
• 多个 repository 之间 id 重复，后声明的会覆盖前一个（Maven 3.8+ 报 warning，但不中断构建）
• id 会出现在本地仓库路径中，比如 ~/.m2/repository/com/alibaba/fastjson/… 不受影响，但 ~/.m2/repository/.cache/aliyun-central/… 这类元数据目录会按 id 分开

启用 releases 和 snapshots 控制开关，别全设为 true

很多团队把 <releases><enabled>true</enabled></releases> 和 <snapshots><enabled>true</enabled></snapshots> 都打开，结果 CI 构建时意外拉到不稳定的快照版，引发线上问题。

• 生产环境 pom.xml 应该关掉 snapshots：<snapshots><enabled>false</enabled></snapshots>
• 内部开发环境可开 snapshots，但建议配合 <updatepolicy>interval:30</updatepolicy>，避免每 build 都查一次
• 有些私仓（如 Nexus）对 snapshot 路径做了权限隔离，enabled=false 能省下一次 HTTP 401 请求

真正容易被忽略的是：Maven 解析 repository 的顺序是从上到下，第一个匹配成功的就停，不会合并多个仓库的结果。所以把最常用、最稳定的仓库（比如阿里云）放在 repositories 列表顶部，比纠结 URL 末尾要不要加 / 实际得多。