Firebase Cloud Functions报错TypeError: snapshot.forEach不是函数，求排查

这个问题我太熟悉了！你遇到的TypeError: snapshot.forEach is not a function错误，核心原因是Firestore的get()方法是异步操作，它返回的是一个Promise对象，而不是你预期的QuerySnapshot。

问题拆解 #

你原来的代码里这一行：

const snapshot = anglersRef.where('anglerNumber', '==', newUserNumber).get();

这里的snapshot其实是一个Promise，不是查询结果的快照对象。Promise没有forEach方法，也没有empty属性——这就是为什么你检查snapshot.empty时，控制台没打印"No matching documents"（因为promise.empty是undefined，条件不成立），同时调用snapshot.forEach会报错。

修正后的代码方案 #

我们需要等待get()方法的Promise resolve，拿到真正的QuerySnapshot后再进行操作。这里有两种常用写法：

方案1：使用async/await（更直观）

exports.newUser = functions.firestore.document('users/{userId}')
  .onCreate(async (snap, context) => {
    const newUserNumber = snap.data().anglerNumber;
    const anglersRef = admin.firestore().collection('anglerNumbers');
    
    // 等待Promise完成，获取真正的QuerySnapshot
    const snapshot = await anglersRef.where('anglerNumber', '==', newUserNumber).get();
    
    if (snapshot.empty) {
      console.log('No matching documents.');
      return;
    }

    // 收集所有删除操作的Promise，确保云函数等待所有操作完成
    const deleteTasks = [];
    snapshot.forEach(doc => {
      console.log(doc.id, '=>', doc.data());
      deleteTasks.push(doc.delete());
    });

    // 等待所有删除任务执行完毕
    return Promise.all(deleteTasks);
  })

方案2：使用.then()链式调用

如果你习惯Promise链式写法，也可以这样写：

exports.newUser = functions.firestore.document('users/{userId}')
  .onCreate((snap, context) => {
    const newUserNumber = snap.data().anglerNumber;
    const anglersRef = admin.firestore().collection('anglerNumbers');

    return anglersRef.where('anglerNumber', '==', newUserNumber).get()
      .then(snapshot => {
        if (snapshot.empty) {
          console.log('No matching documents.');
          return;
        }

        const deleteTasks = [];
        snapshot.forEach(doc => {
          console.log(doc.id, '=>', doc.data());
          deleteTasks.push(doc.delete());
        });

        return Promise.all(deleteTasks);
      })
      .catch(error => {
        console.error('查询或删除文档时出错:', error);
        throw error; // 抛出错误让Firebase标记函数执行失败
      });
  })

关键注意事项 #

1. 必须返回Promise：云函数需要知道异步操作何时完成，如果你不返回Promise，函数会提前终止，导致删除操作可能没执行完就被中断。
2. 错误处理：添加catch块捕获查询或删除过程中的错误，避免函数静默失败，方便你在Firebase控制台排查问题。
3. 批量操作的Promise管理：用Promise.all()等待所有删除任务完成，确保所有匹配的文档都被删除后，函数才标记为执行成功。

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