Flutter&Dart环境下如何删除Firebase文档及其所有子集合

Firestore的documentSnapshot.delete()方法默认仅删除目标文档本身，不会同步删除文档下属的所有子集合，这是官方的既定设计。子集合数据是独立存储的，即使父文档被删除，子集合的残留数据仍然存在，后续创建相同ID的父文档时，仍然可以查询到历史子集合数据。
要实现一次性删除指定文档及其全部所属子集合，且后续创建同ID文档时完全为空，需要按照「从最底层子集合逐层向上删除，最后删除顶层目标文档」的逻辑实现。

已验证可行的Flutter实现代码 #

CollectionReference<Map<String, dynamic>> collectionReference = FirebaseFirestore.instance.collection('collection name').doc('document name').collection('collection name');
DocumentReference<Map<String, dynamic>> documentReference = collectionReference.doc('document name');

documentReference.collection('lists').get().then((lists) {
    lists.docs.forEach((listElement) {
      documentReference.collection('lists').doc(listElement.id.toString()).collection('cards').get().then((cards) {
        cards.docs.forEach((cardElement) {
          documentReference.collection('lists').doc(listElement.id.toString()).collection('cards').doc(cardElement.id.toString()).delete();
        });
      });
      documentReference.collection('lists').doc(listElement.id.toString()).delete();
    });
  });

await documentReference.delete();

注意事项 #

• 上述示例采用Future回调写法，若需要严格保证所有子集合数据全部删除完成后再删除顶层文档，建议调整为async/await写法，避免时序异常导致的删除不完整
• 如果文档下子集合层级不固定、或子集合内文档数量较大，建议将递归删除逻辑部署到Cloud Functions后端执行，避免前端执行时出现网络中断、耗时过长、权限不足等问题
• 生产环境建议增加删除二次确认逻辑，避免误操作导致数据无法找回

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