Firebase Cloud Functions部署异常：CLI成功但Dashboard报错

核心错误提示为[functions] service account IAM check errored, deploy may fail: HTTP Error: 404, Unknown service account，按以下步骤排查：

1. 检查项目服务账号状态 #

• 进入Firebase控制台的项目设置 > 服务账号页面，确认App Engine default service account（格式为[项目ID]@appspot.gserviceaccount.com）是否存在
• 若账号缺失，前往Google Cloud Console的IAM与管理员 > 服务账号页面，创建对应账号并赋予Editor等必要角色

2. 验证CLI关联项目正确性 #

• 执行命令 firebase projects:list，确认当前CLI绑定的项目ID与目标项目一致
• 不一致则执行 firebase use [目标项目ID] 切换项目

3. 确认CLI账号权限 #

• 登录Google Cloud Console的IAM与管理员 > IAM页面，检查当前CLI登录账号是否拥有Cloud Functions Admin和Service Account Admin权限
• 权限缺失时直接添加对应角色

4. 核对配置文件与版本兼容性 #

• 检查functions/package.json中firebase-functions版本与CLI版本（firebase --version）是否兼容，尽量保持大版本一致
• 确认firebase.json的functions配置指向正确目录：

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

5. 查看更详细的部署日志 #

• 前往Google Cloud Console的Cloud Functions页面，若有函数条目，点击查看日志获取加载失败细节
• 若无函数显示，查看Cloud Build的构建日志，排查编译或权限类错误

6. 重新初始化functions模块（可选） #

• 若以上步骤无效，可在functions目录执行 firebase init functions，选择覆盖现有配置（提前备份代码），重新关联项目并安装依赖

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