repository 标签必须写在 repositories 下而非 pluginrepositories 中；repositories 控制依赖 jar 包来源，pluginrepositories 仅影响插件下载；镜像配置优先级高于 pom.xml；repository 的 id 不可重复且不能为 central；releases/snapshots 应按环境合理启用；仓库解析顺序从上到下，首个匹配即生效。
repository 标签写在 repositories 里，不是 pluginRepositories
很多人配完远程仓库没生效，第一反应是地址错了，其实更大概率是放错了位置。Maven 会区分「项目依赖下载用的仓库」和「插件下载用的仓库」，repository 必须嵌套在 repositories 下，否则完全不读取。
-
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 请求
repositories 列表顶部，比纠结 URL 末尾要不要加 / 实际得多。
