从Google Cloud Build部署Firebase托管与函数时遇到问题

API 探路者

2026-6-16

Firebase 托管+函数联合部署错误解决方法

解决虚拟环境（venv）缺失问题

先确认functions目录下是否存在venv虚拟环境，若没有，本地执行以下命令创建：
```
cd functions
python3.12 -m venv venv
```

在Cloud Build的部署步骤中，必须先激活虚拟环境并安装依赖，修改cloudbuild.yaml的步骤配置：

steps:
  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
    entrypoint: 'bash'
    args:
      - '-c'
      - |
        . "/workspace/XXX/functions/venv/bin/activate" && python3.12 -m pip install -r requirements.txt && firebase deploy --project=project-id

若通过CI/CD部署，需确保venv目录被纳入版本控制，或在构建阶段动态创建虚拟环境，避免部署时因缺少环境报错。

解决非交互模式环境变量缺失问题

先通过本地命令firebase functions:config:get查看函数依赖的所有环境变量。

在Cloud Build配置中添加所需环境变量，可选两种方式：

直接在cloudbuild.yaml中定义：

steps:
  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
    env:
      - 'VAR_NAME=var_value'
      - 'ANOTHER_VAR=another_value'
    entrypoint: 'bash'
    args:
      - '-c'
      - |
        . "/workspace/XXX/functions/venv/bin/activate" && python3.12 -m pip install -r requirements.txt && firebase deploy --project=project-id

用Google Cloud Secrets Manager存储敏感变量，构建时拉取：

steps:
  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
    entrypoint: 'bash'
    args:
      - '-c'
      - |
        gcloud secrets versions access latest --secret=MY_SECRET > /workspace/.env
        source /workspace/.env
        . "/workspace/XXX/functions/venv/bin/activate" && python3.12 -m pip install -r requirements.txt && firebase deploy --project=project-id