使用GitHub Actions从ECR拉取Docker镜像到EC2时遇错误求助

错误信息 #

Error response from daemon: repository / not found: name unknown: The repository with name '/' does not exist in the registry with id '***'

排查与解决步骤 #

• 核对仓库路径准确性
  确认docker pull命令中的仓库名称（***/***部分）和实际镜像仓库的路径完全一致，注意大小写、命名空间/用户名的拼写，部分私有仓库对大小写敏感，一旦写错就会触发该错误。

• 验证私有仓库的访问配置
  若使用私有仓库：

  • 检查CI/CD流程中是否在docker pull前执行了docker login操作，且登录凭证拥有该仓库的读取权限
  • 确认错误信息中的注册表ID（***）和你当前使用的仓库实例匹配，避免混淆不同环境（如测试/生产）的私有仓库

• 确认镜像推送状态
  登录仓库管理后台，检查目标仓库是否存在，以及对应标签的镜像是否已成功推送。如果构建推送阶段失败，仓库为空就会出现这个错误。

• 检查CI/CD变量配置
  如果main.yaml中用变量拼接仓库路径，确认变量在部署阶段已正确赋值，比如命名空间、镜像名变量是否传递正确，避免因变量为空或错误导致仓库路径无效。

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