Firebase Firestore多层嵌套子集合多文档查询及通配符路径问题

首先明确：你用的那种带*的集合路径写法不是Firestore查询的合法语法，所以返回空结果是正常的。下面我会详细解释原因，以及正确实现你需求的两种方法。

关于路径中*的含义 #

Firestore里的*通配符只在安全规则中生效，用来匹配任意文档ID（比如规则里的match /collection1/{docId}/...，这里的{docId}和*作用类似）。但在查询代码的集合路径里，*会被当作字面量字符处理——也就是说，你写的collection1/*/collection2/*/collection3会被Firestore理解为一个名为collection1/*/collection2/*/collection3的顶层集合，而这个集合显然不存在，所以返回空的QuerySnapshot。

实现跨多层嵌套子集合查询的两种方法 #

方法1：集合组查询（推荐） #

你的需求是获取所有collection1文档下的collection2文档中的collection3文档，本质上就是查询所有名为collection3的子集合（不管它们的父路径是什么）。Firestore的集合组查询正好是为这个场景设计的，它会匹配数据库中所有同名的集合。

代码示例：

async function fetchAllCollection3Docs() {
  // 调用collectionGroup获取所有名为collection3的集合中的文档
  const querySnap = await admin.firestore().collectionGroup('collection3').get();
  
  if (querySnap.empty) {
    console.log("没有找到任何collection3文档");
    return;
  }

  querySnap.forEach(doc => {
    console.log(`文档ID: ${doc.id}`);
    console.log(`文档数据:`, doc.data());
    // 如果需要查看该文档的完整路径，可以用doc.ref.path
    console.log(`文档路径: ${doc.ref.path}`);
  });
}

// 执行查询
fetchAllCollection3Docs();

注意：如果你的查询需要添加过滤条件（比如where子句），需要先在Firebase控制台为collection3创建对应的复合索引；如果只是获取所有文档，不需要额外创建索引。

方法2：手动递归遍历父集合 #

如果你需要严格限定查询范围（比如只查询collection1→collection2→collection3这个路径下的文档，而排除其他地方同名的collection3集合），可以手动递归遍历每一层父集合的文档：

代码示例：

async function getAllNestedCollection3Docs() {
  // 第一步：获取collection1的所有文档
  const collection1Snapshot = await admin.firestore().collection('collection1').get();
  
  for (const doc1 of collection1Snapshot.docs) {
    // 第二步：获取当前collection1文档下的collection2所有文档
    const collection2Snapshot = await doc1.ref.collection('collection2').get();
    
    for (const doc2 of collection2Snapshot.docs) {
      // 第三步：获取当前collection2文档下的collection3所有文档
      const collection3Snapshot = await doc2.ref.collection('collection3').get();
      
      collection3Snapshot.forEach(doc3 => {
        console.log(`collection3文档ID: ${doc3.id}`);
        console.log(`所属collection2文档: ${doc2.id}`);
        console.log(`所属collection1文档: ${doc1.id}`);
      });
    }
  }
}

// 执行遍历
getAllNestedCollection3Docs();

⚠️ 注意：这种方法会产生大量的读取操作，如果collection1和collection2中的文档数量很多，会显著增加成本和查询耗时，所以优先推荐集合组查询。

总结 #

• 你之前的带*的路径写法无效，因为*不能在查询路径中使用，仅适用于安全规则。
• 优先使用集合组查询来获取所有同名嵌套子集合的文档，简洁高效。
• 若需严格限定路径，可使用递归遍历，但要注意性能和成本问题。

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