Firestore中如何在未知嵌套集合/文档名时查找含指定字段值的深层文档

当前场景的数据结构为顶层Users集合下挂载多个User文档，每个User文档内嵌套同ID的Houses子集合，存储具体房屋信息。需要跨所有嵌套层级定位到目标字段值为WaterHouse的House文档，同时获取它所属的User文档ID和自身文档ID，可按两种场景选择对应实现方案：

方案1：逐层级遍历匹配（小数据量测试场景适用） #

实现逻辑为从顶层集合开始逐层拉取文档，逐份校验字段值，匹配到目标后直接终止遍历。

• 核心流程：
  1. 拉取顶层Users集合的所有文档，逐个提取文档ID
  2. 进入每个User文档下的Houses子集合，拉取全部房屋文档
  3. 逐份校验House文档的目标字段值是否为WaterHouse，匹配后记录所属UserID、HouseID后跳出所有循环
• 代码示例（以Web SDK为例）：

  const db = firebase.firestore();
  let targetResult = null;
  
  // 拉取所有User文档
  const usersSnapshot = await db.collection("Users").get();
  for (const userDoc of usersSnapshot.docs) {
    const currentUserId = userDoc.id;
    // 拉取当前User下的所有House文档
    const housesSnapshot = await userDoc.ref.collection("Houses").get();
    for (const houseDoc of housesSnapshot.docs) {
      // 替换为你实际存储WaterHouse值的字段名
      if (houseDoc.data().houseCategory === "WaterHouse") {
        targetResult = {
          userId: currentUserId,
          houseId: houseDoc.id,
          reference: houseDoc.ref
        };
        break;
      }
    }
    if (targetResult) break;
  }
  

• 注意事项：该方案会拉取路径下所有无关文档，数据量较大时会产生极高的读操作成本，仅适合百级以内用户规模的测试环境使用。

方案2：集合组跨层级查询（生产环境推荐） #

利用Firestore原生的集合组查询能力，无需逐层级遍历User文档，直接全局匹配所有ID为Houses的嵌套集合下的文档。

• 前置准备：需要为存储WaterHouse的目标字段创建集合组索引，未创建时查询会返回索引缺失报错，按报错提示跳转即可一键完成索引配置。
• 代码示例：

  // 跨所有嵌套层级查询Houses集合组，匹配目标字段值
  const matchedSnapshot = await db.collectionGroup("Houses")
    // 替换为你实际存储WaterHouse值的字段名
    .where("houseCategory", "==", "WaterHouse")
    .get();
  
  // 从匹配结果中解析目标ID信息
  matchedSnapshot.forEach(docSnap => {
    // 文档路径格式固定为 Users/{userId}/Houses/{houseId}
    const pathSegments = docSnap.ref.path.split("/");
    const targetInfo = {
      userId: pathSegments[1],
      houseId: docSnap.id,
      data: docSnap.data()
    };
  });
  

• 优势：查询仅返回匹配到的目标文档，不会拉取冗余的无关数据，读操作成本远低于逐层级遍历方案，适配大规模生产数据场景。

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