Firebase Functions V1配置无法获取：Beta迁移至V1问题求助

数据老陈

2026-5-25

解决Firebase Functions V1迁移中process.env.FIREBASE_CONFIG无法获取的问题

我之前在把Firebase Functions从Beta版本迁移到V1的时候，也碰到过和你一模一样的问题，折腾了好一会儿才搞定，给你几个实用的排查和解决方向：

先确认环境变量是否存在
第一步先在函数代码里加一行日志，看看process.env.FIREBASE_CONFIG到底是什么：
```
console.log("当前FIREBASE_CONFIG值:", process.env.FIREBASE_CONFIG);
```
部署或者本地运行后查看日志，如果输出是undefined，那大概率是你的开发/部署环境有问题。
确保firebase-tools是最新版本
旧版本的firebase-tools可能存在环境变量注入的bug，先全局更新到最新版：
```
npm install -g firebase-tools
```
更新后重新本地运行（firebase emulators:start）或者重新部署，再检查日志。
本地开发要关联正确的项目
如果是在本地测试函数，要确保你已经用firebase use <你的项目ID>切换到了正确的Firebase项目，FIREBASE_CONFIG是和当前激活的项目绑定的，项目不对自然拿不到正确的配置。
更省心的替代方案：用Admin SDK默认初始化
V1版本之后，Firebase Admin SDK已经支持自动从环境变量读取配置，完全不需要手动解析process.env.FIREBASE_CONFIG。直接这样初始化Admin SDK即可：
```
const admin = require('firebase-admin');
admin.initializeApp(); // 不需要传任何参数
```
这是官方推荐的方式，能避免手动解析配置带来的各种问题。
CI/CD部署的特殊注意事项
如果是在CI环境部署函数，要确保部署命令正确（firebase deploy --only functions），并且CI环境已经通过服务账号密钥或者OAuth授权了你的Firebase项目，否则环境变量也无法正确注入。