自建Renovate无法查找私有依赖，请求问题排查

架构老林

2026-7-6

问题：Renovate无法查找Artifactory私有Maven依赖

自行部署了Renovate、Gitea和Artifactory，但Renovate返回如下警告：

WARN: Package lookup failures (repository=my_repository, branch=renovate.my_branch)
"warnings": [
"Failed to look up maven package my_group:my_artifactid",
...

当前Renovate配置：

{
  "platform": "gitea",
  "endpoint": "https://mygitea/api/v1/",
  "token": "my_gitea_token",
  "branchPrefix": "renovate.",
  "logFile": "/mydir/renovate.log",
  "logFileLevel": "debug",
  "extends": [ "config:base"],
  "hostRules": [
    {
      "matchHost": "my_artifactory_repo_url",
      "username": "my_artifactory_user",
      "password": "my_artifactory_password"
    }
  ],
  "repositories": [
    "my_repository"
  ]
}

目前仅能识别公共依赖，私有依赖无法被找到，请问可能是什么问题？

可能的排查方向

hostRules匹配规则错误：matchHost需要填写Artifactory的主机名，而非完整仓库URL。例如你的Artifactory地址是https://artifactory.example.com/repo/maven-private，那么matchHost应该设为artifactory.example.com——Renovate是基于主机名匹配认证规则的，带路径的URL会导致匹配失败。
未配置Maven私有仓库地址：仅提供认证信息不足以让Renovate定位私有依赖，需要在配置中添加maven字段指定仓库地址：

"maven": {
  "repositories": [
    {
      "url": "https://your-artifactory-host/repo/maven-private"
    }
  ]
}

Artifactory权限不足：确认配置的用户名和密码拥有该私有Maven仓库的读取权限，可以直接用浏览器或curl工具访问仓库地址，验证是否能获取到my_group:my_artifactid的元数据文件（如maven-metadata.xml）。
仓库路径或类型错误：检查Artifactory中的私有仓库是否配置为Maven类型，路径是否符合Maven仓库的标准结构（通常包含/maven2/前缀或对应仓库的正确路径）。
查看Debug日志：利用已开启的debug日志，检查/mydir/renovate.log中关于Maven包查找的请求详情，确认Renovate是否请求了正确的地址，以及返回的HTTP状态码（401=权限问题，404=路径错误，500=服务端问题等）。

参考文档翻译（原主题：私有包依赖版本查找）

使用私有包时，需确保Renovate能正常访问私有仓库：

配置hostRules：用于提供私有仓库的认证凭据，匹配规则基于主机名而非完整URL。
指定私有仓库地址：针对不同包管理器（如Maven、npm），需在Renovate配置中明确添加私有仓库地址，告知Renovate去哪里查找私有依赖。
验证权限：确保认证账号拥有私有仓库的读取权限，避免因权限不足导致无法获取依赖元数据。

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