Firestore事务在Cloud Functions中表现异常求助

你遇到的异常行为，核心原因是在Firestore事务的回调函数内部执行了异步等待（await testTimeout()），这违反了Firestore事务的设计原则：事务回调需要是一个紧凑的执行流，不能插入无关的异步延迟。

当事务内部加入异步等待时，Firestore会持有目标文档的锁等待操作完成，期间并发的事务请求会被阻塞。同时，Firestore的事务会因为执行超时自动触发重试机制，导致第一个请求的执行时间被大幅拉长（重试叠加耗时），第二个请求则因为等待锁的时间超过Callable函数的超时限制而无响应。

将异步操作移到事务执行前后，确保事务回调内只包含文档读取、校验和修改的核心逻辑：

export const reserveProduct = functions.https.onCall(async (data, context) => {
  function testTimeout() {
    return new Promise((resolve) => {
      setTimeout(() => resolve(true), 3000);
    });
  }

  // 鉴权逻辑保持不变
  if (!context.auth) {
    return { error: 'You must be logged in to reserve products' };
  }

  // 把模拟延迟（实际业务中的非事务异步逻辑）移到事务外部
  await testTimeout();

  const productRef = admin.firestore().collection('products').doc(data.productID);
  const userRef = admin.firestore().collection('users').doc(context.auth.uid);

  try {
    await admin.firestore().runTransaction((transaction) => {
      return transaction.get(productRef).then((doc) => {
        // 校验商品状态
        if (doc.get('status') === 'reserved') {
          throw new Error('Document already reserved!');
        }
        console.log('Product not reserved, reserving now!');

        // 事务内仅执行同步修改操作
        transaction.update(productRef, { status: 'reserved' });
        transaction.update(userRef, { 
          reserved: admin.firestore.FieldValue.arrayUnion(data.productID) 
        });
      });
    });

    console.log('Transaction Successfully committed !');
    return { success: true, message: 'Product reserved successfully' };
  } catch (error) {
    console.error('Transaction failed:', error);
    // 使用Callable函数标准错误类型抛出异常，客户端可正确捕获
    throw new functions.https.HttpsError(
      'already-exists', 
      'Transaction failed, product already reserved'
    );
  }
});

• 事务回调禁止无关异步操作：Firestore事务的回调函数必须尽可能简短，仅处理与文档状态校验、修改相关的逻辑。任何非事务必需的异步操作（如第三方API调用、延迟）都应放在事务执行之外。
• 使用标准错误类型：Callable函数需要通过functions.https.HttpsError抛出结构化错误，而不是字符串，这样客户端能正确识别错误类型并处理。
• 事务的幂等性：Firestore事务会自动重试失败请求（比如文档被其他事务修改），你的业务逻辑必须保证幂等，多次执行不会产生重复预订等副作用。

Callable云函数完全支持Firestore事务，只是需要遵循和客户端SDK一致的事务使用规则——核心是保证事务执行流的紧凑性，避免不必要的延迟。

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