Node.js中如何通过Firebase批量获取指定ID的文档？

你的firebase 9.16.0和firebase-admin 11.5.0版本完全支持批量获取指定ID数组的文档，之前的写法问题出在API使用方式错误，以下是正确实现方案：

核心原理 #

Firestore支持通过FieldPath.documentId()结合in操作符匹配文档ID，但注意**in操作符单次最多支持50个ID**，如果你的indexes数组长度超过50，需要分批处理。

1. Firebase Web SDK v9（模块化）写法 #

v9采用模块化API，必须使用query函数组合集合引用和查询条件，不能直接在集合引用上调用where方法：

import { collection, getDocs, query, where, FieldPath } from "firebase/firestore";

// 假设lineCollection是已初始化的集合引用
const q = query(
  lineCollection,
  where(FieldPath.documentId(), 'in', indexes)
);

const docsSnapshot = await getDocs(q);
const lineData = [];
docsSnapshot.forEach(doc => {
  lineData.push(doc.data());
});

2. Firebase Admin SDK v11.5.0写法 #

Admin SDK仍使用命名空间API，直接在集合引用上调用where方法即可，注意正确导入FieldPath：

const { FieldPath } = require('firebase-admin/firestore');

const docsSnapshot = await lineCollection.where(FieldPath.documentId(), 'in', indexes).get();
const lineData = [];
docsSnapshot.forEach(doc => {
  lineData.push(doc.data());
});

3. 处理超过50个ID的情况 #

如果indexes数组长度超过50，需要分成多个批次并行获取，避免触发Firestore的限制：

// 以Admin SDK为例，Web SDK写法逻辑一致
const { FieldPath } = require('firebase-admin/firestore');

async function batchGetDocuments(collectionRef, ids) {
  const batchSize = 50;
  const batchPromises = [];

  // 切割ID数组为多个50元素的批次
  for (let i = 0; i < ids.length; i += batchSize) {
    const batchIds = ids.slice(i, i + batchSize);
    batchPromises.push(
      collectionRef.where(FieldPath.documentId(), 'in', batchIds).get()
    );
  }

  // 并行执行所有批次请求
  const snapshots = await Promise.all(batchPromises);

  // 合并所有结果
  const result = [];
  snapshots.forEach(snap => {
    snap.forEach(doc => result.push(doc.data()));
  });

  return result;
}

// 使用示例
const lineData = await batchGetDocuments(lineCollection, indexes);

之前写法无效的原因 #

1. where('id', 'in', indexes)：仅当你在文档中手动存储了名为id且值等于文档ID的字段时才会生效，默认情况下文档ID不会作为字段存储在文档中。
2. Web SDK v9中直接调用lineCollection.where(...)：这是v8命名空间API的写法，v9模块化不支持该语法，必须使用query函数组合条件。

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