如何在Firestore中实现集合间文档迁移并避免数据重复？

你当前的逐条写入实现存在两个明显问题：一是会产生大量独立请求，迁移效率低；二是没有原子性保障，中间操作失败会出现数据不一致，也没法保证写入目标和删除源文档的操作同步。
推荐使用Firestore原生的批量写入（Batch Write） 能力实现，优势如下：

• 单批次最高支持500个读写操作，大幅减少请求次数，提升迁移效率
• 批量操作具备原子性，同批次内的所有操作要么全部执行成功，要么全部不生效，避免数据不一致
• 可以把「写入目标集合」和「删除源文档」两个操作绑定在同一个批次中，从根本上避免重复数据或者数据丢失问题

以下是适配Web SDK v9+/Admin SDK的完整实现：

// 1. 查询源集合符合条件的文档快照（带文档ID，后续删除需要用到）
const orderSnapshots = await db.collection("FIRST_COLLECTION").where("status", "==", "ACTIVE").get();
const BATCH_SIZE = 500; // Firestore官方规定的单批次最大操作数限制
const allSourceDocs = orderSnapshots.docs;

// 2. 分批次执行迁移+删除操作
for (let i = 0; i < allSourceDocs.length; i += BATCH_SIZE) {
  // 新建当前批次的操作实例
  const batch = db.batch();
  const currentBatch = allSourceDocs.slice(i, i + BATCH_SIZE);

  currentBatch.forEach(sourceDoc => {
    const orderData = sourceDoc.data() as Order;
    // 操作1：写入目标集合，这里默认和原add逻辑一致自动生成文档ID
    const targetDocRef = db.collection("SECOND_COLLECTION").doc("ID").collection("THIRD_COLLECTION").doc();
    batch.set(targetDocRef, orderData);
    // 操作2：标记删除源集合对应文档
    batch.delete(sourceDoc.ref);
  });

  // 提交批次，原子执行当前批次所有操作
  await batch.commit();
  console.log(`批次${Math.floor(i/BATCH_SIZE) + 1}执行完成，共处理${currentBatch.length}条数据`);
}

• 如果你需要保留源文档的ID到目标集合，把targetDocRef的创建逻辑改为db.collection("SECOND_COLLECTION").doc("ID").collection("THIRD_COLLECTION").doc(sourceDoc.id)即可
• 数据量超过1万条的场景，建议在Firebase Admin SDK的Node.js环境执行，避免客户端权限限制和超时问题
• 正式迁移前建议先拿小批量测试数据验证逻辑，避免误操作删除生产数据

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