Firestore写入文档并控制大小的推荐方案及避免重复读取的方法

核心思路：避免全文档读取的关键 #

不要通过读取整个map来统计条目数，而是在文档中单独维护一个mapEntryCount计数字段，利用Firestore的原子更新操作同时更新map和计数，完全不需要提前读取文档内容。

原子更新示例（JavaScript SDK） #

const targetDoc = db.collection('your-collection').doc('active-doc');

// 同时添加新条目到map，给计数+1
await targetDoc.update({
  [`yourMap.${newKey}`]: newValue,
  mapEntryCount: firebase.firestore.FieldValue.increment(1)
});

阈值判断与自动分档的两种实现方式 #

方式一：客户端事务处理（推荐，保证并发安全） #

通过事务原子性地完成“检查计数→更新/新建文档”的流程，避免并发场景下的冲突：

const THRESHOLD = 100; // 自定义你的条目阈值
const collectionRef = db.collection('your-collection');

await db.runTransaction(async (tx) => {
  const activeDocRef = collectionRef.doc('active-doc');
  const docSnap = await tx.get(activeDocRef);

  if (!docSnap.exists) {
    // 初始化第一个文档
    tx.set(activeDocRef, {
      yourMap: { [newKey]: newValue },
      mapEntryCount: 1
    });
    return;
  }

  const currentCount = docSnap.data().mapEntryCount;
  if (currentCount < THRESHOLD) {
    // 未达阈值，更新现有文档
    tx.update(activeDocRef, {
      [`yourMap.${newKey}`]: newValue,
      mapEntryCount: firebase.firestore.FieldValue.increment(1)
    });
  } else {
    // 新建文档，写入新条目
    // 可自定义命名规则，比如按序号：`doc-${currentCount/THRESHOLD + 1}`
    const newDocRef = collectionRef.doc();
    tx.set(newDocRef, {
      yourMap: { [newKey]: newValue },
      mapEntryCount: 1
    });
    // 可选：更新一个元数据文档，标记当前活跃文档为新创建的文档ID
    tx.set(collectionRef.doc('metadata'), { currentActiveDoc: newDocRef.id });
  }
});

方式二：Cloud Functions触发分档 #

如果希望逻辑完全在服务端处理，可以借助Firestore的写入触发器：

1. 客户端仅负责往当前活跃文档写入数据并更新mapEntryCount；
2. 部署一个Cloud Function，监听集合的文档更新事件；
3. 当检测到mapEntryCount超过阈值时，自动创建新文档，并更新集合的元数据文档，标记后续写入的目标文档为新文档。

这种方式客户端无需处理分档逻辑，但需要额外维护元数据文档来记录当前活跃文档ID。

优化建议 #

• 文档命名规范：采用可排序的命名规则（如batch-001、batch-002），方便后续批量查询和合并数据；
• 阈值合理设置：Firestore单文档上限为1MB，建议阈值远低于该限制（如单map不超过1000条），避免文档体积过大；
• 查询合并：需要读取所有map数据时，通过集合查询获取所有分档文档，在客户端合并多个map的内容即可。

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