如何解决Firebase Cloud Functions中非机密与机密环境变量冲突？

问题场景 #

使用基于Google Cloud的Firebase Cloud Functions（2nd Gen），通过Google Cloud Secret Manager定义机密变量，TypeScript代码中通过defineSecret访问：

import {onRequest} from 'firebase-functions/v2/https';
import {defineSecret} from 'firebase-functions/params';
import * as logger from 'firebase-functions/logger';
import axios from 'axios';
import * as cors from 'cors';
import * as admin from 'firebase-admin';

const var1= defineSecret('VAR1');
const var2 = defineSecret('VAR2');

执行部署命令firebase deploy --only functions时出现报错：

i  functions: updating Node.js 18 (2nd Gen) function sendEmail(us-central1)...
!  functions: HTTP Error: 400, Could not update Cloud Run service projects/<myproject>/locations/us-central1/services/<myapi>. spec.template.spec.containers[0].env: Secret environment variable overlaps non secret environment variable: VAR1
!  functions:  failed to update function projects/<myproject>/locations/us-central1/functions/<myapi>
Failed to update function projects/<myproject>/locations/us-central1/functions/<myapi>

Functions deploy had errors with the following functions:
        myapi(us-central1)
i  functions: cleaning up build files...
!  functions: Unhandled error cleaning up build images. This could result in a small monthly bill if not corrected. You can attempt to delete these images by redeploying or you can delete them manually at https://console.cloud.google.com/gcr/images/<myproject>/us/gcf

Error: There was an error deploying functions

已尝试操作 #

• 删除本地.env文件
• 执行firebase functions:config:unset VAR1 VAR2
• 通过gcloud run services describe <myapi> --format='value(spec.template.spec.containers[0].env)'查看Cloud Run服务环境变量，仅显示机密变量，未发现冲突的非机密变量

解决方法 #

1. 检查firebase.json配置文件 #

打开项目根目录的firebase.json，查看functions节点下是否有env字段定义了VAR1：

{
  "functions": {
    "env": {
      "VAR1": "some-value"
    }
  }
}

如果有，删除该字段后重新部署。

2. 清除Cloud Run服务的所有非机密环境变量 #

执行以下gcloud命令，直接清除目标Cloud Run服务的非机密环境变量（不会影响机密变量）：

gcloud run services update <myapi> --region us-central1 --clear-env

完成后重新执行Firebase部署命令。

3. 检查Cloud Run服务的历史版本 #

登录Google Cloud控制台，进入Cloud Run服务页面，找到<myapi>服务，查看修订版本列表，检查旧版本中是否存在非机密的VAR1环境变量。如果有，可以删除旧版本，或者直接基于最新的无冲突版本重新部署函数。

4. 删除函数后重新部署 #

先删除现有函数：

firebase functions:delete myapi --region us-central1

确认删除后，重新部署函数：

firebase deploy --only functions:myapi

5. 检查构建脚本或package.json的环境变量注入 #

查看项目的package.json或构建脚本（如webpack、vite配置），确认是否在构建过程中自动注入了VAR1作为普通环境变量。如果有，移除相关配置后重新构建部署。

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