Firebase Functions中.env.prod无法覆盖.env配置的问题

问题原因 #

函数的Options配置（如topic、maxInstances）是在本地部署阶段由Node.js进程直接读取环境变量，而函数内部的环境变量是部署到云端后由云端进程读取的。你遇到的问题是本地加载.env文件的顺序错误，导致.env的变量没有被.env.prod覆盖，进而让Options读取了基础.env的值。

修复步骤 #

1. 调整.env文件加载顺序
   在函数入口文件（比如index.js）的最顶部，确保先加载基础.env文件，再加载对应环境的.env.prod文件，让环境特定的变量覆盖基础变量：

   const dotenv = require('dotenv');
   // 获取当前Firebase环境，可通过部署脚本传入
   const activeEnv = process.env.FIREBASE_ENV || 'development';
   
   // 先加载基础配置
   dotenv.config();
   // 加载对应环境的配置，覆盖基础变量
   dotenv.config({ path: `.env.${activeEnv}` });
   

2. 部署时明确指定环境变量
   firebase use prod只是切换项目别名，不会自动设置FIREBASE_ENV，需要在部署时手动传入环境标识。可以在package.json中添加部署脚本：

   "scripts": {
     "deploy:prod": "FIREBASE_ENV=prod firebase deploy --only functions"
   }
   

   之后执行npm run deploy:prod部署生产环境，此时本地Node.js进程会正确加载.env.prod的变量到Options配置中。

3. 验证加载顺序
   可以在入口文件顶部添加日志，确认环境变量的加载结果：

   console.log('当前环境:', activeEnv);
   console.log('maxInstances配置:', process.env.maxInstance);
   console.log('Topic配置:', process.env.TOPIC_NAME);
   

   部署前先执行FIREBASE_ENV=prod node index.js，检查输出是否符合预期。

是否是Cloud Function的Bug？ #

不是。这是由于部署阶段的本地配置解析和云端运行时的环境变量读取是两个独立的流程：

• 部署阶段的Options依赖本地Node.js进程的环境变量，完全由你本地的.env加载逻辑控制；
• 云端运行时的环境变量是Firebase CLI将.env.prod的变量同步到云端后的结果，所以能正确读取。
  问题出在本地.env文件的加载顺序和环境标识的传递上，并非Cloud Function的平台bug。

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