使用curl从JFrog Artifactory下载Docker镜像层后文件为空

排查步骤 #

• 核对Artifactory资源路径
  Docker镜像在Artifactory的存储路径并非简单的/docker_repo/image/tag/sha格式，正确路径通常对应镜像分层文件，比如/docker_repo/v2/image/blobs/sha256:<哈希值>。先确认你要下载的sha对应镜像的具体分层，以及仓库中的实际存储路径。
• 添加调试参数查看请求详情
  执行命令时加上-v参数，查看完整的请求和响应信息，确认服务器返回内容：

  curl -v -O -u username:API_KEY https://artifactory_url/artifactory/docker_repo/image/tag/sha
  

  若响应返回200 OK但内容为空，大概率是该路径下无有效数据；若返回404则路径错误；若返回401/403，需检查API_KEY是否拥有该仓库的读取权限（即便命令提示“执行成功”也需确认）。
• 确认sha的类型
  你使用的sha是镜像manifest的哈希还是分层blob的哈希？如果是manifest哈希，Artifactory应返回JSON格式文件，不会为空；如果是分层哈希，要确认该分层已完整推送到仓库中。
• 手动指定输出文件名测试
  有时-O参数可能因路径解析问题导致输出异常，试试手动指定文件名：

  curl -u username:API_KEY https://artifactory_url/artifactory/docker_repo/image/tag/sha > output.file
  

  查看output.file的内容和大小，判断是服务器返回空还是本地输出环节出问题。

常见修复方案 #

• 修正Artifactory资源路径，确保指向存在的镜像分层或manifest文件。
• 验证API_KEY权限，确认其拥有目标Docker仓库的读取权限。
• 检查镜像是否完整推送至Artifactory，避免分层缺失。

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