Firebase报错TypeError: Path必须为字符串，请求排查配置问题

首先，从你的错误栈来看，这个Path must be a string. Received undefined错误并不是直接来自Firebase的数据库操作，而是来自dir-glob模块（被globby调用）在处理文件路径时收到了undefined值。结合你的代码和使用场景，我梳理了几个可能的问题点和对应的解决办法：

1. 模块导入的解构错误 #

在firebase_db.js中，你导入firebaseConfig.js的方式是：

const firebaseDb = require("./../config/firebaseConfig.js")

但firebaseConfig.js导出的是一个包含db属性的对象：module.exports = { db }。虽然你后续用firebaseDb.db可以访问到实例，但这种写法容易出错（比如如果导出结构变化），更规范的写法是解构导入：

const { db } = require("./../config/firebaseConfig.js")

这样后续直接用db.collection('users').add(...)即可，避免多余的属性访问层级。

2. Firebase配置文件的路径错误 #

检查firebaseConfig.js中导入functions-config.json的路径：

const firebaseConfigJSON = require("./functions-config.json")

假设你的项目结构是：

google-functions/
  functions/
    index.js
    src/
      config/
        firebaseConfig.js
      helperFunctions/
        firebase_db.js
    functions-config.json

那么firebaseConfig.js位于src/config/目录，要访问根目录的functions-config.json，路径应该是../../functions-config.json，而不是./。如果路径错误，虽然通常require会直接抛出"模块未找到"的错误，但某些情况下可能导致传入admin.credential.cert()的参数异常，间接引发后续的路径处理错误。

修正后的代码：

const firebaseConfigJSON = require("../../functions-config.json")

3. 移除不必要的Firestore设置 #

你在初始化Firestore后添加了：

db.settings({ timestampsInSnapshots: true });

这个配置在Firebase Admin SDK v6.0.0及以上版本已经默认启用，不需要手动设置，移除这行代码可以避免潜在的配置冲突。

4. 检查本地运行环境的依赖与脚本 #

错误栈中的dir-glob和globby通常是文件扫描工具的依赖，可能和你本地运行项目的方式有关：

• 如果你用firebase serve运行函数，检查firebase.json中的functions.source路径是否正确指向你的functions目录；
• 如果你用Express本地运行，检查package.json中的启动脚本是否有路径相关的错误参数；
• 尝试删除node_modules和package-lock.json，重新执行npm install，排除依赖安装异常的问题。

验证配置正确性 #

确认你的functions-config.json是从Firebase控制台下载的服务账号密钥，格式应该类似：

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "...",
  "private_key": "...",
  "client_email": "...",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "..."
}

确保这个文件的内容完整且路径正确，这样admin.credential.cert()才能正常初始化Firebase Admin实例。

按照以上步骤逐一排查，应该能解决你遇到的路径错误问题，顺利完成Firebase集合的创建操作。

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