本地运行Firebase Functions时runtime配置为空如何解决

1. 优先处理webpack打包配置（核心诱因） #

你当前集成的webpack是导致config读取失败的最常见原因：firebase-functions的config()方法依赖运行时动态读取当前工作目录下的.runtimeconfig.json文件，如果webpack将firebase-functions打包进了最终产物，会破坏其内部的路径解析逻辑，导致无法定位配置文件。
在你的webpack配置文件中添加externals规则，将firebase-functions标记为外部依赖不参与打包：

module.exports = {
  // 其余现有配置不变
  externals: ['firebase-functions']
}

2. 修正.runtimeconfig.json的存放位置 #

如果webpack有单独的输出目录（比如默认的dist文件夹），需要把.runtimeconfig.json同步复制到打包后的输出根目录下，和你的函数入口文件同级。
你可以直接修改打包脚本自动完成复制：

// package.json
{
  "scripts": {
    "build": "webpack && cp .runtimeconfig.json dist/"
  }
}

也可以安装copy-webpack-plugin插件在打包流程中自动处理文件复制。

3. 手动指定配置文件路径启动模拟器 #

如果上述配置后仍有问题，可以在启动命令中显式指定配置文件路径，跳过自动路径解析逻辑：

FUNCTIONS_EMULATOR_CONFIG_FILE=./.runtimeconfig.json firebase emulators:start --only functions

4. 版本兼容修复 #

你当前使用的firebase-functions v3.15.4存在已知的本地配置读取bug，可以升级到v3分支的最新稳定版，或者临时降级到v3.14.1验证是否解决问题：

npm install firebase-functions@3.14.1

另外你代码中重复导入config的写法不会直接导致问题，但建议简化为单次导入，避免不必要的隐患：

import { config } from 'firebase-functions';
const runtimeConfig = config() as CloudRuntimeConfig;

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