Firebase Cloud Functions：未知路径下获取Firestore指定ID文档

问题分析 #

你的核心思路没问题——用collectionGroup("Cheap")可以跨所有父文档查询同名子集合，但代码存在几个关键问题导致查询失败：

• 语法错误：catch块内的注释误删了闭合括号，导致代码无法正常执行
• 未创建Collection Group查询必需的复合索引
• 未正确处理查询结果，没有提取目标文档的字段

修正后的代码 #

以下是修复语法、优化逻辑后的完整代码，统一使用async/await风格提升可读性：

const functions = require("firebase-functions");
const admin = require("firebase-admin");
const cors = require("cors")({ origin: true }); // 确保已安装cors依赖

admin.initializeApp(); // 必须初始化Firebase Admin

exports.test = functions.https.onRequest((req, res) => {
  cors(req, res, async () => {
    try {
      // 执行跨集合查询，匹配所有Cheap集合下ID为Soap的文档
      const querySnapshot = await admin.firestore()
        .collectionGroup("Cheap")
        .where(admin.firestore.FieldPath.documentId(), "==", "Soap")
        .get();

      if (querySnapshot.empty) {
        console.log("未找到匹配的Soap文档");
        return res.status(404).send("未找到目标文档");
      }

      // 提取所有匹配文档的字段（支持多父文档场景）
      const soapDataList = [];
      querySnapshot.forEach(doc => {
        soapDataList.push({
          documentId: doc.id,
          parentDocumentPath: doc.ref.parent.parent.path, // 可选：获取父文档路径
          fields: doc.data() // 提取文档所有字段
        });
      });

      console.log("查询到的Soap文档数据：", soapDataList);
      res.status(200).json(soapDataList); // 以JSON格式返回结果
    } catch (err) {
      console.error("查询失败：", err);
      res.status(500).send(`查询出错：${err.message}`);
    }
  });
});

关键注意事项 #

• 创建复合索引：首次运行查询时，Firebase控制台日志会输出一个索引创建链接，点击链接直接完成索引创建即可——这是Collection Group查询的强制要求，否则会返回权限或索引错误。
• 依赖安装：确保已在项目中安装cors包，执行命令：npm install cors
• 结果处理：如果确定只有一个父文档下存在Cheap/Soap，可以简化结果提取逻辑为querySnapshot.docs[0].data()直接获取第一个文档的字段。

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