Flutter中如何删除Firestore含文档及子集合的集合？

你的代码没有生效的原因很明确：

• 你只是在内存中修改了doc.data对象，没有调用Firestore的删除API，根本不会触发云端数据删除。
• Firestore不支持直接删除带有子集合的集合，必须递归删除所有子集合和文档。

下面分两种场景给出可行的实现方案：

一、客户端递归删除（适合数据量较小的场景） #

如果你的集合文档数量不多（几百个以内），可以直接在Flutter客户端实现递归删除：

老版本cloud_firestore（v3及以下）代码 #

// 递归删除集合及其所有子集合、文档
Future<void> deleteCollection(CollectionReference collection) async {
  // 获取当前集合下的所有文档
  final snapshot = await collection.getDocuments();
  
  for (final doc in snapshot.documents) {
    // 先删除该文档的所有子集合
    final subCollectionIds = await doc.reference.getCollectionIds();
    for (final subColId in subCollectionIds) {
      await deleteCollection(doc.reference.collection(subColId));
    }
    // 删除当前文档
    await doc.reference.delete();
    print("已删除文档: ${doc.documentID}");
  }
}

// 调用删除函数
AllDelete() async {
  final user = await _auth.currentUser();
  if (user == null) return;
  
  final soruCollection = Firestore.instance.collection('users').document(user.uid).collection("SORU");
  await deleteCollection(soruCollection);
  print("SORU集合及其子集合已全部删除");
}

新版本cloud_firestore（v4及以上）代码 #

新版本API有调整，对应代码如下：

// 递归删除集合及其所有子集合、文档
Future<void> deleteCollection(CollectionReference<Map<String, dynamic>> collection) async {
  final snapshot = await collection.get();
  
  for (final doc in snapshot.docs) {
    // 获取文档下的所有子集合
    final subCollections = await doc.reference.listCollections();
    for (final subCol in subCollections) {
      await deleteCollection(subCol);
    }
    // 删除当前文档
    await doc.reference.delete();
    print("已删除文档: ${doc.id}");
  }
}

// 调用删除函数
AllDelete() async {
  final user = await FirebaseAuth.instance.currentUser;
  if (user == null) return;
  
  final soruCollection = FirebaseFirestore.instance.collection('users').doc(user.uid).collection("SORU");
  await deleteCollection(soruCollection);
  print("SORU集合及其子集合已全部删除");
}

注意：客户端删除有速率限制，数据量过大时容易触发Firestore的限流机制，导致删除失败。

二、云函数批量删除（适合大量数据的场景） #

如果集合包含数千甚至更多文档，建议用Firebase云函数执行删除，服务器端的限流阈值更高，适合大规模操作：

1. 编写Node.js云函数 #

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

// 批量递归删除集合
async function deleteCollection(collectionRef, batchSize = 500) {
  const snapshot = await collectionRef.limit(batchSize).get();
  if (snapshot.size === 0) return 0;

  // 批量删除当前批次的文档
  const batch = admin.firestore().batch();
  snapshot.docs.forEach(doc => batch.delete(doc.ref));
  await batch.commit();

  // 递归删除当前批次文档的子集合
  for (const doc of snapshot.docs) {
    const subCollections = await doc.ref.listCollections();
    for (const subCol of subCollections) {
      await deleteCollection(subCol, batchSize);
    }
  }

  // 递归删除剩余文档
  return snapshot.size + await deleteCollection(collectionRef, batchSize);
}

// 暴露可调用的云函数
exports.deleteSoruCollection = functions.https.onCall(async (data, context) => {
  if (!context.auth) {
    throw new functions.https.HttpsError("unauthenticated", "用户未登录");
  }
  
  const userId = context.auth.uid;
  const soruCollection = admin.firestore().collection(`users/${userId}/SORU`);
  const deletedCount = await deleteCollection(soruCollection);
  
  return { message: `已删除${deletedCount}个文档及所有子集合` };
});

2. Flutter客户端调用云函数 #

AllDelete() async {
  final user = await FirebaseAuth.instance.currentUser;
  if (user == null) return;
  
  final functions = FirebaseFunctions.instance;
  try {
    final result = await functions.httpsCallable('deleteSoruCollection').call();
    print(result.data['message']);
  } catch (e) {
    print("删除失败: ${e.toString()}");
  }
}

注意：云函数单次执行最长9分钟，若数据量极大，可能需要拆分任务多次执行。

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