Firestore如何根据已知多个文档ID高效批量获取对应文档

不需要逐个调用单文档的get或onSnapshot，Firestore原生就提供了批量读取能力，性能远高于循环单读，也是和Algolia这类搜索服务搭配时的通用最优用法。

一次性拉取场景（无实时更新需求） #

根据你用的SDK版本选对应方案即可，20个ID的规模单次请求就能完成，不需要拆分：

• 优先用getAll方法：服务端Admin SDK、Web v9.5+ 版本SDK都内置了这个方法，支持直接传入多个文档引用，底层只走一次网络往返，返回结果顺序和你传入的文档引用顺序完全一致。示例代码：

// Web v9 示例
import { doc, getAll } from "firebase/firestore";
// 假设从Algolia拿到的文档ID列表存在docIds数组中
const docRefs = docIds.map(id => doc(db, "目标集合名", id));
const docSnapshots = await getAll(...docRefs);
// 遍历快照即可拿到文档数据，不存在的ID对应的快照exists属性为false

• 老版本SDK用in条件查询：如果你的SDK版本不支持getAll，直接构造以文档ID为匹配条件的in查询即可，目前in操作符单次最多支持传入30个匹配值，20个ID一次就能查完。示例代码：

import { collection, query, where, documentId, getDocs } from "firebase/firestore";
const batchQuery = query(
  collection(db, "目标集合名"),
  where(documentId(), "in", docIds)
);
const querySnapshot = await getDocs(batchQuery);

注意：in查询返回的结果不会保留你传入ID的原有顺序，如果需要对齐顺序，拿到结果后先转成文档ID: 文档数据的映射表再按原ID列表取值即可。

实时监听场景（需要同步文档变更） #

如果需要监听这批文档的实时更新，不需要给每个文档单独绑定onSnapshot，直接给上面构造的in条件查询对象绑定onSnapshot即可，一次监听就能覆盖所有目标文档的变更，不会产生和文档数量对等的监听连接，性能开销和监听单个查询一致。

注意事项 #

• 如果后续你的ID列表规模超过30个，只需要把ID列表按每30个一组拆分，并发发起批量查询即可，性能远高于循环单文档读取。
• 所有批量读取的计费规则和单文档读取完全一致，按实际返回的文档数量计费，没有额外开销。
• 和Algolia这类搜索服务搭配时，不需要在搜索服务中存储全量文档字段，只存搜索需要的字段+文档ID，拿到ID后用上述批量方法拉Firestore全量数据即可，是成本最低、性能最优的组合方案。

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