如何让.env变量在Firebase部署阶段可用？

1. 这是Firebase的有意设计吗？ #

是的，这是第二代Cloud Functions的正常行为。Firebase CLI在Loading and analyzing source code阶段仅负责解析代码结构（比如识别要部署的导出函数），不会自动加载.env.[project-name]文件中的环境变量——这些变量是在函数部署完成后，运行容器启动时才会注入到process.env中的，和部署阶段的CLI执行环境完全隔离。

2. 如何让.env变量在部署阶段可用？ #

可以通过手动加载.env文件，在部署命令执行前将变量注入到CLI的运行环境中：

• 先安装dotenv-cli开发依赖：

  npm install dotenv-cli --save-dev
  

• 然后修改部署命令，通过dotenv-cli指定要加载的.env文件：

  npx dotenv-cli -e .env.[project-name] firebase deploy --only functions
  

• 也可以在package.json的scripts里配置快捷命令：

  "scripts": {
    "deploy:functions": "dotenv-cli -e .env.my-codebase -- firebase deploy --only functions"
  }
  

  之后执行npm run deploy:functions即可，这样CLI在加载分析代码时就能访问到.env里的变量了。

3. 模块根级别执行代码是否推荐？ #

不推荐。根级代码会在两个时机执行：

• Firebase CLI部署时的代码分析阶段
• 函数冷启动时的初始化阶段
  这会导致不必要的重复执行，而且如果依赖环境变量，很容易出现部署阶段变量缺失的报错。

第二代函数的最佳实践是：将需要依赖环境变量的初始化逻辑放在函数内部，或者使用懒加载模式，只在函数被触发时才执行相关代码。比如：

// 不推荐：根级执行依赖环境变量的代码
const client = new SomeClient(process.env.API_KEY);

// 推荐：函数内部初始化
exports.myFunction = onRequest((req, res) => {
  const client = new SomeClient(process.env.API_KEY);
  // 函数逻辑
});

// 或者懒加载（优化冷启动）
let client;
exports.myFunction = onRequest((req, res) => {
  if (!client) {
    client = new SomeClient(process.env.API_KEY);
  }
  // 函数逻辑
});

关于functions:config的差异 #

之前使用functions:config时能在根级使用变量，是因为Firebase CLI会在部署阶段主动将config变量注入到代码中（替换代码里的functions.config()调用），而第二代函数的.env变量是运行时注入，两者的生效机制完全不同，所以旧方法不再适用。

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