Firebase Cloud Function部署失败，出现多类V1/V2相关错误

错误背景 #

使用Firebase CLI部署V1函数时，突然出现三类错误：

• 无法向V2版本的Cloud Functions API发送请求
• 无法获取Firebase项目（权限/项目存在性提示）
• 无法访问Cloud Build服务

已尝试登出重登、更新Firebase CLI（当前版本13.10.1）无效，NPM版本9.5.0，项目未修改环境或依赖。

排查与解决步骤 #

• 强制锁定V1部署模式
  避免CLI自动触发V2资源检测，在部署命令中明确指定V1：

  firebase deploy --only functions:你的函数名 --force
  

  或在firebase.json中添加全局配置：

  {
    "functions": {
      "gen": 1,
      "runtime": "nodejs18" // 替换为你实际使用的V1运行时版本
    }
  }
  

• 验证权限与服务状态

  • 确认当前登录账号拥有项目的Cloud Functions Developer和Cloud Build Editor权限，去Google Cloud控制台IAM页面核对。
  • 检查cloudbuild.googleapis.com服务是否启用：在Google Cloud控制台的「API和服务」中找到该服务，确保状态为已启用。
  • 确认Cloud Functions、Cloud Build服务无故障，查看Google Cloud状态面板。

• 清理本地缓存与依赖

  • 清除Firebase CLI缓存并重新登录：

    firebase logout
    rm -rf ~/.cache/firebase
    firebase login
    

  • 重建函数依赖：

    cd functions
    rm -rf node_modules package-lock.json
    npm install
    

• 调整CLI版本
  特定版本可能存在兼容问题，尝试降级到稳定版或升级到最新版：

  # 降级到13.8.0稳定版
  npm install -g firebase-tools@13.8.0
  # 或升级到最新版
  npm install -g firebase-tools@latest
  

• 应急部署方案
  若以上方法无效，改用gcloud CLI直接部署：

  gcloud functions deploy 你的函数名 --runtime nodejs18 --trigger-http --project 你的项目ID
  

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