调用GCP Artifact Registry下载接口无返回，如何获取文件？

核心原因 #

Artifact Registry的:download接口不会直接在响应体返回文件内容，而是通过返回3xx重定向状态码，引导你到文件的临时存储URL获取内容。你之前拿到空响应{}，大概率是因为HTTP客户端没有处理重定向，或者请求参数/权限有误。

具体解决步骤 #

• 确认请求有效性

  • 确保调用的端点路径完全正确：格式为https://artifactregistry.googleapis.com/v1/{文件完整资源名}:download，其中文件完整资源名可以从get接口返回的元数据里的name字段直接复制，比如projects/my-proj/locations/us-central1/repositories/my-repo/packages/my-pkg/versions/v1/files/my-file.bin
  • 验证身份权限：请求头必须携带有效的Authorization: Bearer [访问令牌]，令牌需要拥有artifactregistry.files.download权限（可通过服务账号或gcloud生成）

• 处理重定向获取文件

  • 使用curl时，添加-L参数自动跟随重定向，同时用-o指定输出文件：

    curl -L -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://artifactregistry.googleapis.com/v1/{文件完整资源名}:download" \
      -o my-downloaded-file.bin
    

  • 使用Postman时，在请求设置里开启「Automatically follow redirects」选项，重新调用接口后就能获取文件内容

• 排查异常情况

  • 如果仍然返回空响应，检查资源名是否和get接口返回的完全一致（注意大小写、路径分隔符）
  • 确认令牌未过期，且对应的账号有权限访问该文件（可通过gcloud artifacts files describe {文件资源名}验证权限）

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