Maven配置Artifactory多私有仓库依赖拉取失败问题

你的核心问题是Maven镜像的优先级覆盖了POM中配置的仓库，导致新依赖被错误路由到没有该依赖的Myfolder-2仓库，而非你配置的Myfolder-1。下面是问题根源分析和两种可行的解决方案：

问题根源 #

Maven镜像（mirror）的优先级高于POM里的<repository>配置。当你在settings.xml中配置了<mirrorOf>central</mirrorOf>的镜像后，所有原本指向central仓库的依赖都会被导向Myfolder-2。而你的新依赖不在Myfolder-2中，即便POM里加了MyId-1仓库，Maven仍会优先遵循镜像规则，尝试从Myfolder-2查找，自然会失败。

另外，你尝试新增<mirrorOf>*</mirrorOf>的镜像时，Maven会按镜像定义顺序匹配最精确的规则——第一个镜像已经匹配了central，若新依赖被归为central范畴，还是会走Myfolder-2，第二个镜像的*规则不会生效。

解决方案一：调整镜像匹配规则，精准路由依赖 #

这种方式无需改动Artifactory配置，只需调整settings.xml的镜像规则，同时保留POM中的仓库配置：

1. 保留父POM中的<repository>配置不变：

   <repository>
     <id>MyId-1</id>
     <url>https://artifactory-url/artifactory/Myfolder-1/</url>
     <layout>default</layout>
   </repository>
   

2. 修改settings.xml的mirrors配置，让MyId-2镜像排除MyId-1仓库，同时新增专门匹配MyId-1仓库的镜像：

   <mirrors>
     <mirror>
       <id>MyId-2</id>
       <mirrorOf>central,!MyId-1</mirrorOf> <!-- 排除MyId-1仓库，不代理它 -->
       <name>MyName-2</name>
       <url>https://artifactory-url/artifactory/Myfolder-2/</url>
     </mirror>
     <mirror>
       <id>MyId-1-mirror</id>
       <mirrorOf>MyId-1</mirrorOf> <!-- 仅代理MyId-1仓库 -->
       <name>MyName-1</name>
       <url>https://artifactory-url/artifactory/Myfolder-1/</url>
     </mirror>
   </mirrors>
   

3. 确保settings.xml中的<server>配置与MyId-1完全对应：

   <server>
     <id>MyId-1</id>
     <username>{username}</username>
     <password>{password}</password>
   </server>
   

配置后，Maven会将MyId-1仓库的依赖导向对应的镜像，其他central范畴的依赖走Myfolder-2，互不干扰。

解决方案二：使用Artifactory虚拟仓库（推荐） #

这是更优雅的方案，利用Artifactory的虚拟仓库功能，将Myfolder-1和Myfolder-2合并为一个统一入口，避免本地配置复杂的镜像规则：

1. 在Artifactory中创建虚拟仓库（比如命名为maven-combined）：

   • 进入Artifactory仓库管理界面，选择创建虚拟仓库
   • 将Myfolder-1和Myfolder-2添加到虚拟仓库的「成员仓库」列表（可调整顺序，Maven会按顺序查找依赖）

2. 修改settings.xml的镜像配置，指向这个虚拟仓库：

   <mirrors>
     <mirror>
       <id>maven-combined-mirror</id>
       <mirrorOf>*</mirrorOf>
       <name>Combined Maven Repository</name>
       <url>https://artifactory-url/artifactory/maven-combined/</url>
     </mirror>
   </mirrors>
   

3. 可删除POM中新增的<repository>配置，所有依赖都会通过虚拟仓库自动在Myfolder-1和Myfolder-2中查找。

这种方式的优势是依赖查找逻辑集中在Artifactory管理，无需在每个项目或本地settings中配置多仓库/镜像，后续新增仓库只需更新虚拟仓库的成员即可。

排查验证步骤 #

若配置后仍有问题，可通过以下方式定位：

• 执行mvn dependency:tree -X查看详细日志，搜索目标依赖，确认Maven实际访问的仓库URL
• 登录Artifactory，检查Myfolder-1中是否存在该依赖的POM文件，路径是否符合Maven仓库结构（groupId/artifactId/version/artifactId-version.pom）
• 确认settings.xml中的server id与POM/repository中的id完全一致（Maven对id大小写敏感）

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