部署Firebase函数时构建镜像清理失败问题求助

错误修复步骤 #

1. 启用缺失的API #

Docker报错404找不到us.gcr.io仓库，大概率是因为项目未启用Container Registry API。虽然你已启用Artifact Registry API，但清理流程可能仍会尝试访问旧的GCR仓库，需补充启用：

• 进入Google Cloud控制台的API库，搜索「Container Registry API」并启用。

2. 配置Docker访问凭证 #

确保Docker客户端能正确访问GCR和AR仓库，执行以下命令重新配置凭证：

gcloud auth configure-docker us.gcr.io,us-central1-docker.pkg.dev

3. 强制使用Artifact Registry部署 #

避免清理旧GCR镜像的步骤，部署时指定--use-artifact-registry参数，让Firebase CLI完全使用Artifact Registry：

firebase deploy --only functions --use-artifact-registry

4. 手动清理残留镜像 #

若自动清理仍失败，手动删除相关镜像：

• GCR镜像清理（若存在）：

  gcloud container images list-tags us.gcr.io/[你的项目ID]/gcf --format='get(digest)' | xargs -I {} gcloud container images delete us.gcr.io/[你的项目ID]/gcf@{} --quiet
  

• AR镜像清理：

  gcloud artifacts docker images list us-central1-docker.pkg.dev/[你的项目ID]/gcf-artifacts --format='get(digest)' | xargs -I {} gcloud artifacts docker images delete us-central1-docker.pkg.dev/[你的项目ID]/gcf-artifacts@{} --quiet
  

  替换[你的项目ID]为实际项目ID，执行前可先去掉--quiet预览要删除的内容。

5. 升级Firebase CLI #

旧版本CLI可能存在仓库迁移兼容性问题，升级到最新版本：

npm install -g firebase-tools

计费相关说明 #

• 该错误本身与计费无直接关联，但未清理的镜像会占用Cloud存储资源，产生小额月度存储费用，这也是警告提示的原因。
• 计费信息查看路径：
  • 进入Google Cloud控制台，选择对应项目；
  • 左侧菜单点击「计费」→「账单详情」；
  • 在「成本探索」模块中，筛选「Artifact Registry」或「Container Registry」类型的费用，即可查看镜像存储产生的支出；
  • 也可在Firebase控制台的「项目设置」→「计费」页面，查看关联的Cloud账单汇总。

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