如何根据Maven构件坐标编程查找pom.xml需添加的公共仓库

问题背景 #

• 很多Maven使用者都会遇到这类情况：部分构件既不在本地仓库，也不在默认的Maven中央仓库中，需要手动在pom.xml内添加对应仓库的id与url配置。如果是项目原始开发者做这个操作难度很低，但作为后续接手的项目维护者，手动查找对应仓库效率极低。
• 典型场景：从GitHub获取的Maven项目依赖org.openhab.addons.bundles:org.openhab.addons.reactor.bundles:3.2.0-SNAPSHOT，该构件并未收录在Maven中央仓库。常规手动处理方式是通过搜索引擎检索构件关键字，尝试查找可添加到pom.xml的公共仓库配置，示例配置如下：

<repositories>
  <repository>
    <id>openhab</id>
    <url>https://openhab.jfrog.io/openhab/libs-release/</url>
  </repository>
</repositories>

核心诉求为：在已知Maven构件groupId:artifactId:version坐标的前提下，如何通过编程方式自动查找需要添加到pom.xml中的对应公共仓库。

可落地的实现方案 #

不存在能覆盖100%公共仓库的万能查询接口，但通过以下分层检索逻辑，可以覆盖绝大多数公开构件的场景，实现自动化查找：

• 第一层：预置主流公共仓库批量校验
  提前维护一份主流公共Maven仓库的根地址清单（包含各大开源组织公开仓库、公共制品托管实例、常用第三方公共仓库），按照Maven仓库的标准存储规则，为每个仓库拼接构件的资源路径做存在性校验：
  标准路径拼接规则为：{仓库根地址}/{groupId将点替换为斜杠}/{artifactId}/{version}/{artifactId}-{version}.pom
  对拼接后的地址发起HEAD请求，如果返回200状态码，即可确认构件存在于当前仓库，直接提取该仓库的id和url作为结果即可。
  比如校验前述openHAB构件时，拼接的校验路径为https://openhab.jfrog.io/openhab/libs-release/org/openhab/addons/bundles/org.openhab.addons.reactor.bundles/3.2.0-SNAPSHOT/org.openhab.addons.reactor.bundles-3.2.0-SNAPSHOT.pom，请求返回200即可确认仓库匹配。
• 第二层：按版本类型缩小检索范围
  如果构件版本带有-SNAPSHOT后缀，优先遍历所有预置仓库的SNAPSHOT存储路径做校验，绝大多数公共仓库会将快照版本和正式发布版本分目录存储，这个规则可以过滤掉60%以上的无效请求，大幅提升检索效率。
• 第三层：元数据检索兜底
  对于不在预置仓库列表内的构件，可以通过解析主流Maven构件检索站点的查询结果，提取结果中标注的构件所属仓库地址，提取到地址后必须再通过第一层的路径校验规则做二次验证，确认构件确实存在于该仓库后再返回结果，避免拿到错误的仓库配置。

实现注意事项 #

• 所有检索到的仓库地址必须经过实际存在性校验，禁止直接返回未验证的检索结果，避免将无效配置写入pom.xml导致项目构建失败。
• 遍历仓库发起请求时要设置合理的超时时间，同时控制并发数，避免因单个仓库响应异常拖慢整个检索流程。
• 如果遍历完所有检索路径都无法找到对应构件，直接返回明确提示，说明该构件可能存储在私有仓库、已被删除或未公开分发，不要返回不匹配的结果。

内容的提问来源于stack exchange，提问作者mason