Firestore循环使用updateDoc报错：如何实现下单商品库存递减？

错误原因 #

你代码里的问题是把getDoc返回的DocumentSnapshot对象传给了updateDoc，但updateDoc要求第一个参数必须是DocumentReference（文档引用）对象。循环中你用let doc = await getDoc(docs[i])把快照赋值给了doc变量，覆盖了原本的文档引用，导致参数类型不匹配，触发了Error: Expected type 'af', but it was: a custom fg object错误。

方案1：修正循环中的参数传递 #

只需要修改循环里的变量名避免覆盖文档引用，同时确保updateDoc接收的是原始的DocumentReference：

const app = initializeApp(firebaseConfig);
const db = getFirestore(app);

// 变量名改为docRefs，明确是文档引用数组
let docRefs = [doc(db, "myCollection", 'a'), doc(db, "myCollection", 'b')];

async function test() {
  for (let i = 0; i < docRefs.length; i++) {
    // 用snapshot接收查询结果，避免覆盖文档引用
    let snapshot = await getDoc(docRefs[i]);
    console.log(snapshot.data());
    // 传入文档引用docRefs[i]而非快照
    await updateDoc(docRefs[i], {
      num: increment(-1)
    })
  }
}

test();

方案2：使用批量更新（推荐） #

循环逐个更新会产生多次网络请求，用Firestore的批量操作可以把所有更新合并为一次请求，更高效，也更适合批量修改场景：

const app = initializeApp(firebaseConfig);
const db = getFirestore(app);

let docRefs = [doc(db, "myCollection", 'a'), doc(db, "myCollection", 'b')];

async function test() {
  // 创建批量操作实例
  const batch = writeBatch(db);
  
  // 可选：批量获取所有文档快照（如果需要查看当前数据）
  const snapshots = await Promise.all(docRefs.map(ref => getDoc(ref)));
  snapshots.forEach(snapshot => {
    console.log(snapshot.data());
  });
  
  // 为每个文档添加增量更新操作
  docRefs.forEach(ref => {
    batch.update(ref, {
      num: increment(-1)
    });
  });
  
  // 提交批量操作
  await batch.commit();
  console.log("库存批量更新完成");
}

test();

注意事项 #

• 确保increment是Firestore官方提供的函数：
  • 模块化SDK需导入：import { increment } from "firebase/firestore";
  • 旧版命名空间SDK使用：firebase.firestore.FieldValue.increment(-1)
• 批量操作最多支持500个文档，若需更新更多文档，需拆分多个批次
• Firestore的增量更新是原子操作，能安全处理并发修改，不用担心库存超卖问题

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