Firebase批量删除含嵌套子集合的文档失败问题排查

• 子集合不会阻塞父文档删除，但删除父文档不会自动级联删除子集合文档。你当前的批量操作没有处理masseges子集合下的独立文档，这些文档后续会变成无父文档的孤儿数据残留，但这不是父文档删除失败的直接原因。
• 安全规则配置存在两处致命错误：
  1. data-set-a、data-set-b的规则路径存在语法错误，正确路径格式应为/data-set-a/{Id}/sub-set-a/{subId}，你写的路径缺失了变量包裹符{和路径分隔符/，规则完全不生效。
  2. Firestore安全规则为路径精确匹配，权限不会沿路径上下继承。你只给data-set-c下最深层的masseges/{mgsId}配置了删除权限，完全没有配置上层父文档/data-set-c/{Id}/sub-set-c/{subSetId}的删除权限，删除docC的请求会被规则直接拦截，这是data-set-c对应文档无法删除的核心原因。
• 前端代码存在基础语法问题：创建colA、colB的集合引用时，路径片段data-set-a、sub-set-a、data-set-b、sub-set-b是字符串字面量，没有加引号，会被JS引擎识别为未定义变量直接抛错。
• 单次writeBatch操作最多支持500条写入/删除动作，如果你后续masseges子集合下的消息量增长，总删除文档数超过500时，前端批量操作会直接失败。

第一步：修正安全规则 #

替换原有错误规则，显式覆盖所有需要删除的文档路径：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // 匹配data-set-a下的sub-set-a文档
    match /data-set-a/{Id}/sub-set-a/{subId} {
      allow delete: if request.auth != null 
        && request.auth.token.email_verified
        && request.auth.uid == Id;
    }
    // 匹配data-set-b下的sub-set-b文档
    match /data-set-b/{Id}/sub-set-b/{subId} {
      allow delete: if request.auth != null 
        && request.auth.token.email_verified
        && request.auth.uid == Id;
    }
    // 匹配data-set-c下的sub-set-c父文档
    match /data-set-c/{Id}/sub-set-c/{subSetId} {
      allow delete: if request.auth != null 
        && request.auth.token.email_verified
        && request.auth.uid == Id;
      // 匹配嵌套的masseges子集合文档
      match /masseges/{mgsId} {
        allow delete: if request.auth != null 
          && request.auth.token.email_verified
          && request.auth.uid == Id;
      }
    }
  }
}

注意：Firestore安全规则不会沿路径上下继承，父路径配置的权限不会自动生效到子路径，子路径权限也不会向上覆盖父路径，每个需要操作的路径都必须显式配置对应权限。

第二步：修正前端批量删除代码 #

先查询所有待删除的父文档、子集合文档，统一加入批量操作后提交，注意控制单次操作总条数不超过500：

const batch = writeBatch(db);
const uid = _authContext.currentUser.uid;

// 加入data-set-a、data-set-b、data-set-c下的待删父文档
const docA = doc(db, 'data-set-a', uid, 'sub-set-a', subSetId);
const docB = doc(db, 'data-set-b', uid, 'sub-set-b', subSetId);
const docC = doc(db, 'data-set-c', uid, 'sub-set-c', subSetId);
batch.delete(docA);
batch.delete(docB);
batch.delete(docC);

// 查询data-set-c下嵌套masseges子集合的所有文档，加入批量删除
const msgCol = collection(db, 'data-set-c', uid, 'sub-set-c', subSetId, 'masseges');
const msgSnapshot = await getDocs(msgCol);
msgSnapshot.docs.forEach(msgDoc => {
  batch.delete(msgDoc.ref);
});

// 提交批量操作
await batch.commit();

第三步：大数据量场景适配 #

如果后续masseges子集合下的文档数量较多，单次批量操作总文档数（3个父文档+消息文档）超过500条，必须改用云函数实现级联删除：

• 可配置sub-set-c文档删除的onDelete触发事件，自动递归删除其下所有子集合文档
• 云函数端运行不受前端500条批量操作的限制，可以分批递归删除所有嵌套文档，同时不需要在前端暴露全量子集合查询权限，安全性更高。

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