如何在Node.js云函数与后台函数中实现Firebase写后读事务

首先得澄清你遇到的困惑：虽然官方文档提到服务器端SDK支持事务中的写后读，但这个支持是有前提的——仅允许读取已经在事务内预先读取过的文档，而不是全新的、从未在事务内读取过的文档。你的错误正是因为违反了这个规则。

为什么会触发Error: Firestore transactions require all reads to be executed before all writes？ #

看你的代码，核心问题有两个：

1. 你在事务外部使用admin.firestore().collection('tests').doc().get()读取文档，这绕过了事务的一致性追踪，Firestore不会将这次读操作纳入事务的上下文。
2. 你在事务内先执行了t.set()写操作，然后调用t.get()读取一个从未在事务内读取过的文档（即使是同一个ref，之前的读是在事务外），这直接触发了Firestore的事务规则校验。

Firestore的事务机制要求：所有需要在事务中读取的文档，必须在任何写操作之前通过transaction.get()完成读取；服务器端允许的"写后读"，仅针对那些已经在事务内读过的文档（比如先读、修改、再读确认状态）。

解决方法 #

根据你的需求，分两种情况处理：

情况1：你需要写入新文档并获取其ID/写入的数据 #

这种情况完全不需要额外的读操作，因为你已经知道自己要写入的内容，也可以直接获取文档ID：

// 修正后的HTTP云函数
const tests_get = async (req, res) => {
  try {
    const testResult = await admin.firestore().runTransaction(async (t) => {
      // 生成新文档的引用
      const testDocRef = admin.firestore().collection('tests').doc();
      // 预先在事务内读取这个文档（即使它不存在）
      await t.get(testDocRef);
      // 执行写操作
      const writeData = {}; // 替换成你的实际写入数据
      await t.set(testDocRef, writeData);
      // 直接返回构造的结果，不需要再读
      return {
        id: testDocRef.id,
        ...writeData
      };
    });
    res.send({ id: testResult.id });
  } catch (e) {
    res.status(400).send({ error: e.message });
  }
};

情况2：你需要读取已修改文档的最新状态（比如依赖服务器生成字段） #

如果是修改已有文档，并且需要确认修改后的状态（比如包含serverTimestamp或自动生成的字段），可以先在事务内读取文档，修改后再次读取同一个文档：

const updateAndRead = async () => {
  const docRef = admin.firestore().collection('tests').doc('existing-doc-id');
  const result = await admin.firestore().runTransaction(async (t) => {
    // 第一步：事务内预先读取文档
    const docSnap = await t.get(docRef);
    // 第二步：执行写操作
    await t.update(docRef, {
      count: (docSnap.data().count || 0) + 1,
      updatedAt: admin.firestore.FieldValue.serverTimestamp()
    });
    // 第三步：再次读取同一个已读过的文档（服务器端允许）
    const updatedSnap = await t.get(docRef);
    return updatedSnap.data();
  });
  console.log(result);
};

关键注意事项 #

• 所有事务中涉及的文档，必须使用transaction.get()在事务内读取，不能使用事务外的firestore.get()，否则事务无法追踪该文档的状态变化。
• 服务器端的"写后读"仅适用于已在事务内读取过的文档，不能用于全新的、未在事务内预先读取的文档。
• 尽量避免不必要的写后读操作，因为你通常可以直接使用自己写入的数据构造结果，减少事务的执行时间和资源消耗。

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