Firebase默认helloworld函数部署失败，提示找不到对应镜像如何解决？

解决步骤 #

请按以下优先级逐一排查：

• 升级firebase-tools工具版本
  该报错大概率是旧版本firebase-tools对Node 14的兼容问题，先查看本地工具版本：

  firebase --version
  

  若版本低于9.23.0，执行全局升级：

  npm install -g firebase-tools
  

  升级完成后重新尝试部署。
• 验证账号权限与服务状态
  1. 确认当前登录的Firebase账号拥有目标项目的Cloud Functions Developer与Storage Admin权限，部署过程需要向容器注册表推送构建好的函数镜像，权限不足会导致镜像推送失败
  2. 确认GCP对应项目已启用容器注册表服务，且未出现服务异常
  3. 确认项目已绑定有效的支付方式，未被平台限制资源创建
• 更换部署区域测试
  尝试将函数指定到其他区域部署，避免us-central1区域的临时资源限制，修改index.js中函数定义：

  exports.helloWorld = functions.region('us-east1').https.onRequest((request, response) => {
    functions.logger.info("Hello logs!", {structuredData: true});
    response.send("Hello from Firebase!");
  });
  

  重新执行部署命令。
• 清理缓存后重新部署
  执行以下操作清理本地与云端残留的异常构建缓存：

  // 进入functions目录
  cd functions
  // 删除本地依赖与锁文件
  rm -rf node_modules package-lock.json
  // 重新安装依赖
  npm install
  // 重新登录firebase账号
  firebase logout && firebase login
  // 清理函数构建缓存
  firebase functions:clean
  // 强制部署
  firebase deploy --only functions --force
  

• 检查firebase.json配置
  确认项目根目录的firebase.json中functions配置指向正确的源码目录，默认配置如下：

  {
    "functions": {
      "source": "functions"
    }
  }
  

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