如何在ReactJS中批量将对象数组覆盖写入Firestore集合？

我有如下对象数组：

resolvingArray = [
    {
        invoiceId: "user",
        userId: 3
    },
    {
        invoiceId: "test",
        userId: 10
    },
    {
        invoiceId: "yolo",
        userId: 12
    },
]

我希望将整个对象数组写入Firestore集合resolvingInvoices，用这个数组覆盖整个集合（即集合最终只包含数组中的这些文档，替换原有所有内容）。目前我的代码只能更新集合里的单个文档resolving：

export async function updateResolvingInvoices(
  data: DocumentData
): Promise<returnType> {
  if (!checkCounter())
    return { data: null, error: SERVER_COUNTS.ERROR_MAX_COUNT };

  return await setDoc(doc(db, "resolvingInvoices", "resolving"), data)
    .then(() => {
      return { data: true, error: null };
    })
    .catch((err) => {
      return { data: null, error: err };
    });
}

请问如何修改代码实现需求？

要实现用对象数组覆盖整个Firestore集合，需要完成两个核心操作：清空集合原有所有文档 + 批量写入数组中的新文档。Firestore的批量写操作支持原子性执行，能保证操作的一致性。

修改后的代码示例 #

import { writeBatch, collection, getDocs, doc, DocumentData } from "firebase/firestore";

export async function updateResolvingInvoices(
  dataArray: DocumentData[]
): Promise<returnType> {
  if (!checkCounter())
    return { data: null, error: SERVER_COUNTS.ERROR_MAX_COUNT };

  try {
    const batch = writeBatch(db);
    const resolvingCol = collection(db, "resolvingInvoices");

    // 1. 删除集合中所有现有文档
    const existingDocs = await getDocs(resolvingCol);
    existingDocs.forEach(docSnap => {
      batch.delete(docSnap.ref);
    });

    // 2. 批量添加新文档（用invoiceId作为文档ID，保证唯一性）
    dataArray.forEach(item => {
      const docRef = doc(resolvingCol, item.invoiceId);
      batch.set(docRef, item);
    });

    // 提交批量操作
    await batch.commit();

    return { data: true, error: null };
  } catch (err) {
    return { data: null, error: err };
  }
}

关键说明 #

• 单次批量操作最多支持500个任务，如果数组长度加上现有文档总数超过500，需要拆分多次批量提交（可通过循环分批处理）。
• 用invoiceId作为文档ID，既避免重复，也方便后续通过invoiceId快速定位单个文档。
• 批量操作是原子性的：要么所有删除和写入操作都成功，要么全部失败，不会出现集合内容部分更新的情况。

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