Firebase Node.js Cloud Functions自定义服务账号部署问题

问题分析 #

部署第二代Firebase Node.js云函数时，若想使用自定义服务账号替代默认的App Engine账号，直接用firebase deploy --only functions无法传递--service-account参数；而直接调用gcloud functions deploy命令时，由于Firebase函数的构建依赖Firebase CLI的打包流程，gcloud无法找到正确的构建产物（如function.js），进而触发构建失败报错。

正确实现步骤 #

方法1：通过firebase.json配置服务账号 #

在项目根目录的firebase.json文件中添加配置，可全局或针对单个函数指定服务账号：

• 全局配置（所有函数共用）：

{
  "functions": {
    "serviceAccount": "SA@PROJECT_ID.iam.gserviceaccount.com"
  }
}

• 单函数配置（仅指定函数生效）：

{
  "functions": {
    "v2": {
      "FUNCTION_NAME": {
        "serviceAccount": "SA@PROJECT_ID.iam.gserviceaccount.com"
      }
    }
  }
}

配置完成后，执行常规Firebase部署命令即可：

firebase deploy --only functions

方法2：先构建再用gcloud部署 #

1. 先用Firebase CLI完成函数打包构建：

# 方式1：模拟部署触发构建
firebase deploy --only functions --dry-run
# 方式2：直接执行构建命令
firebase functions:build

构建产物会生成在functions/lib（TypeScript项目）或functions目录（JavaScript项目）下。
2. 用gcloud命令指定构建目录和服务账号部署：

gcloud functions deploy FUNCTION_NAME \
  --service-account "SA@PROJECT_ID.iam.gserviceaccount.com" \
  --source=./functions \
  --runtime=nodejs18 # 替换为你的Node.js版本

注意事项 #

• 确保自定义服务账号拥有云函数部署所需权限，例如Cloud Functions Developer、Service Account User等
• 第二代云函数需使用firebase.json中的v2字段做单独配置

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