部署Google Functions至europe-west1时遇404及镜像查找失败问题求助

问题背景 #

已在函数代码和firebase.json中设置区域为europe-west1，执行部署命令：

firebase deploy --only functions:myFunction --debug

先后遇到以下错误：

1. 请求https://eu.gcr.io/v2/my-app/gcf/europe-west1/tags/list返回404
2. 修复GCR访问后，出现新错误：

   Could not find image for function projects/my-app/locations/europe-west1/functions/myFunction
   

   以及Artifact Registry的404报错：

   {"error":{"code":404,"message":"Package \"projects/my-app/locations/europe-west1/repositories/gcf-artifacts/packages/myFunction\" was not found.","status":"NOT_FOUND"}}
   

3. Artifact Registry中存在4个空的*.gcr.io仓库，自动创建的gcf-artifacts仓库内有函数镜像，但名称格式为my--app__europe--west1__myFunction，系统无法识别匹配。

排查与解决思路 #

• 核对区域配置一致性
  确保代码与配置文件的区域完全统一：

  • 函数代码里显式指定区域，比如Node.js：

    exports.myFunction = functions.region('europe-west1').https.onRequest(...);
    

  • firebase.json的functions配置：

    {
      "functions": {
        "region": "europe-west1",
        "source": "functions"
      }
    }
    

  单函数部署时，避免局部配置和全局配置冲突。

• 清理旧仓库与本地缓存

  • 删除Artifact Registry中那些空的*.gcr.io仓库，避免部署工具混淆仓库路径
  • 清除Firebase CLI本地缓存并重新部署：

    firebase functions:delete myFunction --region europe-west1 --force
    rm -rf .firebase/
    rm -rf functions/node_modules/.cache/
    cd functions && npm install && cd ..
    firebase deploy --only functions:myFunction
    

• 检查权限与镜像命名映射

  • 确认当前登录账号对gcf-artifacts仓库拥有Artifact Registry Reader和Writer权限
  • 镜像名称的转义格式（my--app__europe--west1__myFunction）是Firebase自动生成的，若识别异常，可尝试在firebase.json手动指定镜像路径：

    {
      "functions": {
        "region": "europe-west1",
        "source": "functions",
        "docker": {
          "image": "europe-west1-docker.pkg.dev/my-app/gcf-artifacts/myFunction"
        }
      }
    }
    

  注意替换实际项目ID和函数名。

• 调整Firebase CLI版本
  旧版CLI可能存在区域适配问题，尝试升级到最新稳定版：

  npm install -g firebase-tools@latest
  

  或回退到已知兼容版本（如12.x系列）测试。

• 验证项目与区域关联
  确认项目my-app支持europe-west1区域（可在GCP控制台区域列表核对），且部署命令未隐式指定其他区域覆盖配置。

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