Firebase Functions本地配置变量调用错误及调试问题

我之前在本地调试Firebase函数时也踩过配置读取的坑，结合你描述的情况，咱们一步步来梳理问题：

首先看你提供的.runtimeconfig.json内容，第一个明显的问题就是JSON语法错误——所有的占位符值（比如MY_CLIENT_ID、SOME_URL这些）都没有用双引号包裹，JSON规范要求字符串类型的值必须用双引号，否则会直接导致配置解析失败。正确的格式应该是这样：

{
  "auth": {
    "clientid": "MY_CLIENT_ID",
    "signoutreturnto": "SOME_URL",
    "responsetype": "SOME_RESPONSE_TYPE",
    "redirecturi": "SOME_OTHER_URL",
    "scope": "SOME_OTHER_STRING"
  }
}

除了语法问题，还可以按下面的步骤逐一排查：

• 确认文件位置和命名
  一定要保证.runtimeconfig.json放在functions目录的根目录下，和package.json、函数入口文件（比如index.js/index.ts）同级。另外注意文件名是隐藏文件，Windows系统下需要开启「显示隐藏文件」才能看到，别不小心建到了子目录里。

• 重启本地服务
  Firebase本地模拟器/服务不会自动监听.runtimeconfig.json的修改，如果你已经启动了firebase serve --only functions或者firebase emulators:start，修改配置后必须重启服务，新的配置才会生效。

• 验证配置是否成功加载
  可以临时写个测试函数来确认配置是否被正确读取：

  const functions = require('firebase-functions');
  
  exports.checkConfig = functions.https.onRequest((req, res) => {
    const config = functions.config();
    console.log('当前加载的配置:', config);
    res.send(config);
  });
  

  重启服务后访问这个测试接口，或者查看终端日志，看看auth相关的字段是否正常显示。

• 检查配置冲突
  如果你之前用过firebase functions:config:get > .runtimeconfig.json命令导出过云端配置，手动修改时要注意不要有旧的字段干扰，必要的话可以先清空文件内容，再重新写入你需要的配置。

另外提醒一下：本地的.runtimeconfig.json只是用于开发调试，不会上传到云端，云端的函数配置还是需要用firebase functions:config:set命令来设置。

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