Firestore嵌套文档查询：Node.js中根据手机号查找随机文档

要解决这个问题，我们需要利用Firestore的**集合组查询（Collection Group Query）**来定位到目标手机号对应的contacts文档，再通过文档路径回溯找到父级的randomDoc。下面是具体实现步骤和代码：

核心思路 #

因为你的contacts是directory文档下的子集合，且每个子集合的文档ID是手机号，我们无法直接从directory集合反向查询子集合内容。所以需要：

1. 用集合组查询匹配所有contacts子集合中ID为目标手机号的文档
2. 从匹配到的contacts文档的路径中，获取对应的directory父文档
3. 收集这些父文档的信息

完整Node.js代码实现 #

const admin = require('firebase-admin');
const firestore = admin.firestore;

// 先确保Firebase Admin SDK已初始化（如果还没初始化，取消下面注释并配置）
// admin.initializeApp({
//   credential: admin.credential.applicationDefault()
// });

const db = admin.firestore();
const targetPhone = '9212345677';

async function getMatchingDirectoryDocs() {
  try {
    // 执行集合组查询，找到所有contacts子集合中ID等于目标手机号的文档
    const contactsQuery = db.collectionGroup('contacts')
      .where(firestore.FieldPath.documentId(), '==', targetPhone);
    
    const contactsSnapshot = await contactsQuery.get();

    if (contactsSnapshot.empty) {
      console.log('未找到包含该手机号的directory文档');
      return [];
    }

    // 遍历查询结果，获取对应的directory父文档
    const matchingDirectoryDocs = [];
    for (const contactDoc of contactsSnapshot.docs) {
      // 文档路径结构：/directory/{randomDocId}/contacts/{phone}
      // 所以父文档引用是当前文档引用的父级的父级
      const directoryDocRef = contactDoc.ref.parent.parent;
      const directoryDoc = await directoryDocRef.get();

      if (directoryDoc.exists) {
        matchingDirectoryDocs.push({
          docId: directoryDoc.id,
          docData: directoryDoc.data()
        });
      }
    }

    console.log('找到的匹配文档：', matchingDirectoryDocs);
    return matchingDirectoryDocs;
  } catch (err) {
    console.error('查询过程出错：', err);
    throw err;
  }
}

// 调用查询函数
getMatchingDirectoryDocs();

关键细节说明 #

• 集合组查询：collectionGroup('contacts')会扫描数据库中所有名为contacts的子集合，不管它们属于哪个父文档，这是实现跨子集合查询的核心。
• 文档ID查询：因为contacts的文档ID是手机号，所以用firestore.FieldPath.documentId()来匹配文档ID，而不是普通字段查询。
• 路径回溯：contactDoc.ref.parent指向的是当前contacts文档所在的contacts集合，再调用.parent就得到了directory下的随机文档引用。

注意事项 #

第一次运行这个查询时，Firestore可能会抛出索引缺失的错误。此时你可以直接点击错误信息中的链接，跳转到Firestore控制台自动创建所需的集合组索引；也可以手动在控制台的「索引」页面创建，选择集合组为contacts，字段为__name__（对应文档ID），排序方式为「等于」。

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