从Firebase实时数据库迁移至Firestore：如何仅通过Key查找文档？

我完全理解你从Firebase实时数据库迁移到Firestore时的困惑——实时数据库的树形结构让跨层级找Key变得很直接，但Firestore的文档-集合模型没有原生的全局Key检索能力。结合你的需求，我整理了几种可行的方案，你可以根据自己的数据结构选择：

情况1：你的目标Key是文档的ID #

如果原来实时数据库里的Key对应Firestore中文档的ID（也就是创建文档时指定的doc(key)），那Firestore没有办法直接全局搜索所有文档ID，因为文档ID是和所在集合绑定的。这里有两种解决思路：

方案1：维护全局索引集合 #

创建一个专门的索引集合（比如叫documentKeyIndex），每次创建或更新目标文档时，同步在这个索引集合里存一条记录：用你的目标Key作为文档ID，字段里存储对应文档的完整路径（比如/routes/abc123）。这样查询时先查索引，再定位到目标文档：

async function getSingleRouteById(key) {
  // 先查询索引集合获取文档路径
  const indexDoc = await firestore.collection('documentKeyIndex').doc(key).get();
  
  if (!indexDoc.exists) {
    return null; // 没找到对应记录
  }

  const targetDocPath = indexDoc.data().targetPath;
  // 根据路径获取目标文档
  const targetDoc = await firestore.doc(targetDocPath).get();
  
  return targetDoc.exists ? targetDoc.data() : null;
}

注意：要确保在创建/删除目标文档时同步更新这个索引集合，避免数据不一致。

方案2：遍历已知的可能集合 #

如果你能列出所有可能存储目标文档的集合名称（比如routes、archivedRoutes），可以逐个查询这些集合里的文档ID是否匹配：

async function getSingleRouteById(key) {
  // 替换成你实际的集合列表
  const possibleCollections = ['routes', 'archivedRoutes', 'userRoutes'];

  for (const colName of possibleCollections) {
    const doc = await firestore.collection(colName).doc(key).get();
    if (doc.exists) {
      return doc.data();
    }
  }
  
  return null; // 所有集合都没找到
}

缺点：如果集合数量多，会发起多个请求，效率较低；后续新增集合时需要同步更新这个列表。

情况2：你的目标Key是文档中的字段 #

如果原来的Key对应Firestore文档里的某个字段（比如每个文档都有key字段存储这个值），可以根据集合结构选择：

方案1：集合组查询（适用于同名子集合） #

如果所有目标文档都存放在同名的子集合里（比如不管父文档是什么，子集合都叫routes），可以用集合组查询一次性检索所有同名子集合：

async function getSingleRouteById(key) {
  const querySnapshot = await firestore.collectionGroup('routes')
    .where('key', '==', key)
    .get();

  if (querySnapshot.empty) {
    return null;
  }
  
  // 假设key是唯一的，返回第一个结果
  return querySnapshot.docs[0].data();
}

注意：首次执行集合组查询时，Firestore控制台会提示你创建对应的索引，按照提示操作即可。

方案2：遍历已知集合查询字段 #

如果目标文档分散在不同名称的集合里，还是需要遍历可能的集合，用字段匹配查询：

async function getSingleRouteById(key) {
  const possibleCollections = ['routes', 'otherRouteCollections'];

  for (const colName of possibleCollections) {
    const querySnapshot = await firestore.collection(colName)
      .where('key', '==', key)
      .get();
    
    if (!querySnapshot.empty) {
      return querySnapshot.docs[0].data();
    }
  }
  
  return null;
}

核心差异说明 #

最后再提一句：Firestore和实时数据库的设计理念不同——实时数据库是树形NoSQL，支持深度路径查找；而Firestore是文档-集合模型，更偏向扁平结构，没有原生的全局键值检索能力。所以这类场景下，提前规划索引或者明确集合结构是必要的。

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