虚拟仓库首次拉取本地包返回404，优先查询远程仓库

原因 #

• 本地仓库索引未同步：repoA上传packageX后，Artifactory的索引未及时更新，虚拟仓库首次检索时找不到该包的索引记录，直接跳过repoA去查repoB，返回404；首次请求触发索引扫描后，第二次就能正确识别repoA中的包。
• 负缓存机制干扰：首次请求时若repoA临时出现检索延迟或状态异常，Artifactory会临时标记它无法提供该包，转而查询repoB；repoB返回的404会被短暂缓存，后续Artifactory检测到repoA恢复正常，第二次请求就直接从repoA获取。
• 检索配置异常：尽管repoA排序在前，但可能存在以下情况：repoA的包含/排除规则过滤了请求路径；虚拟仓库开启了远程仓库优先的隐藏配置；或是repoA未处于启用状态，导致首次请求跳过本地仓库。

解决方法 #

• 强制更新本地仓库索引：
  • 进入Artifactory管理后台，找到repoA仓库，在「内容」或「维护」标签下点击「索引」按钮，手动触发仓库内容扫描更新索引。
  • 配置自动索引频率，设置为实时或短间隔（如每小时），确保新上传的包能被及时识别。
• 调整负缓存设置：
  • 进入虚拟仓库的高级设置，找到负缓存TTL配置，缩短其生存时间（比如设为1分钟），或临时禁用负缓存测试。
  • 检查repoA的状态，确保本地仓库无权限、存储或连接问题，避免被Artifactory标记为不可用。
• 校验虚拟仓库检索配置：
  • 确认虚拟仓库的成员仓库排序确实是repoA在前，且repoA处于启用状态。
  • 检查repoA的包含/排除模式，确保请求的包路径未被过滤，比如packageX的路径符合包含规则。
  • 关闭虚拟仓库中可能存在的「远程优先」类特殊检索选项。
• 清理缓存并测试：
  • 出现404后，在虚拟仓库的「缓存」标签下手动清理缓存，再重新请求验证。
  • 使用curl测试时添加-H "Cache-Control: no-cache"参数，避免客户端缓存干扰结果。

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