Firebase Cloud Functions删除用户时跨集合删文档报错排查

需求：删除Firebase用户账号时，通过后端Cloud Functions自动清除该用户关联的所有跨集合文档，现有单集合文档删除方案无法覆盖跨多集合删除的场景。
当前数据库集合结构：

users 
  | uid
      | email: userEmail@test.com


orders 
  | docId
      | createdBy: uid
      | …
      | …

当前编写的云函数代码：

const userDeleted = functions.auth.user().onDelete(user => {
  // 删除users集合下的用户主文档
  const usersRef = db.collection("users").doc(user.uid);
  usersRef.delete();
  
  // 删除orders集合下该用户关联的所有文档
  const ordersRef = db.collection("orders")
    .where("createdBy", "==", user.uid)
    .get()
    .then(snapshot => {
      snapshot.forEach(doc => {
        ordersRef.doc(doc.id).delete();
      });
    })
    .catch(err => {
      console.log("Error getting documents", err);
    });

  return Promise.all(usersRef, ordersRef);
})

实际测试现象：onDelete触发后无法完成多文档删除，Firebase日志返回错误：
object is not iterable (cannot read property Symbol(Symbol.iterator)) at Function.all
错误定位在Promise.all调用行。

代码存在3个核心问题直接导致报错和功能失效：

• Promise.all 要求传入由Promise组成的可迭代对象（通常是数组），传入的第一个参数usersRef是文档引用对象，根本不是Promise；第二个参数ordersRef也没有正确包裹内部所有删除操作的Promise，直接触发了「对象不可迭代」的报错。
• 遍历orders集合查询结果执行删除时，forEach内部每个doc.ref.delete()都是异步操作，但没有收集这些操作返回的Promise，外层的then回调没有返回任何值，云函数无法感知这些删除任务的执行状态，很可能任务没跑完就被系统回收。
• 代码中usersRef.delete()本身是异步返回Promise的操作，没有被加入等待队列，会出现用户主文档删除失败但函数已经正常退出的情况。

const functions = require('firebase-functions');
const admin = require('firebase-admin');
const db = admin.firestore();

const userDeleted = functions.auth.user().onDelete(async (user) => {
  try {
    // 存储所有待执行的删除任务
    const deleteTasks = [];

    // 添加users集合用户主文档删除任务
    const userDocDeleteTask = db.collection("users").doc(user.uid).delete();
    deleteTasks.push(userDocDeleteTask);

    // 查询orders集合下该用户关联的所有文档
    const ordersSnapshot = await db.collection("orders")
      .where("createdBy", "==", user.uid)
      .get();
    
    // 将所有关联订单的删除操作加入任务队列
    ordersSnapshot.forEach(doc => {
      deleteTasks.push(doc.ref.delete());
    });

    // 后续如果需要清理其他集合（如posts、comments、favorites等），按照上述逻辑查询后将删除任务加入deleteTasks即可

    // 等待所有删除任务执行完成
    await Promise.all(deleteTasks);
    console.log(`用户${user.uid}关联数据全部清理完成`);
    return null;
  } catch (err) {
    console.error(`清理用户${user.uid}关联数据失败:`, err);
    throw err;
  }
})

• 推荐用async/await语法替代链式then调用，逻辑更清晰，不容易漏写Promise等待逻辑。
• 所有数据库异步操作必须全部加入Promise队列等待执行完成，云函数在检测到没有待执行的异步任务时会主动回收进程，未执行完的删除操作会被强制中断。
• 如果单个集合下关联的用户文档超过500条，建议使用Firebase的批量写入（Batched Write）实现删除，单次批量操作最多支持500个文档操作，避免触发请求上限。
• 该方案天然支持跨集合扩展，后续新增关联集合时只需要重复「查询对应用户关联文档 -> 将删除操作加入任务数组 -> 统一等待执行」的流程即可。

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