Firestore事务内执行fetch请求报错：无法修改已提交的WriteBatch

错误原因 #

Firestore的WriteBatch和事务有严格的生命周期限制：事务/batch内部只能包含Firestore自身的异步操作，不能嵌入外部网络请求（比如你的fetchData）。外部异步请求会导致Firestore提前将batch标记为已提交状态，后续再对batch进行修改（比如填充集合的set操作）就会触发Error: Cannot modify a WriteBatch that has been committed。

解决方案（兼顾懒加载需求） #

拆分流程为两个阶段（推荐） #

既保证数据一致性，又避免不必要的fetch请求：

• 第一阶段：事务内仅做存在性验证
  只在事务中执行步骤1-3：计算文档引用、查询已有文档、验证是否存在。此阶段不执行任何写入操作，仅返回是否需要发起fetch请求的判断结果。
• 第二阶段：按需fetch并写入数据
  如果第一阶段判定文档不存在（需要写入），再执行await fetchData(item.detailUrl)获取详情，随后开启新的WriteBatch或事务，完成一级、二级集合的填充操作。

示例伪代码：

// 第一阶段：事务内验证文档是否存在
const needFetch = await db.runTransaction(async (transaction) => {
  const targetDocRef = db.collection('your-collection').doc(calculatedDocId);
  const docSnapshot = await transaction.get(targetDocRef);
  return !docSnapshot.exists;
});

// 第二阶段：按需执行fetch并写入
if (needFetch) {
  const detailData = await fetchData(item.detailUrl);
  
  const batch = db.batch();
  // 填充一级集合
  batch.set(firstLevelDocRef, { ...yourFirstLevelData, ...detailData });
  // 填充二级集合
  batch.set(secondLevelDocRef, yourSecondLevelData);
  
  await batch.commit();
}

不推荐的方案：事务内包含fetch #

如果一定要在事务中处理，需确保fetch操作完全在事务函数内部完成，且等待fetch结束后再执行写入。但这种方式会拉长事务执行时间，大幅增加事务超时或失败的概率，不建议使用。

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