Flutter删除Firebase用户文档、子集合及认证记录时listCollections报错解决

错误原因 #

Firestore的客户端SDK（包括Flutter使用的firebase_core/firebase_firestore包）不支持调用listCollections()方法，这个方法仅能在Firebase Admin SDK中使用。你在Flutter代码里直接调用该方法，必然会触发权限或功能限制错误。

针对性解决办法 #

因为你已经明确知道子集合是books和pdfs，不需要动态识别未知集合，直接硬编码处理即可，步骤如下：

1. 编写删除子集合所有文档的工具函数 #

import 'package:cloud_firestore/cloud_firestore.dart';

// 删除指定集合下的所有文档
Future<void> deleteCollection(String collectionPath) async {
  final collectionRef = FirebaseFirestore.instance.collection(collectionPath);
  final querySnapshot = await collectionRef.get();

  // 批量删除（注意：Firestore批量操作最多支持500个操作，文档过多需分页处理）
  final batch = FirebaseFirestore.instance.batch();
  for (final doc in querySnapshot.docs) {
    batch.delete(doc.reference);
  }
  await batch.commit();
}

2. 完整的用户数据删除流程 #

先删除子集合文档，再删除用户主文档，最后删除Authentication用户记录：

import 'package:firebase_auth/firebase_auth.dart';

Future<void> deleteUserAndAllData(String userId) async {
  try {
    // 1. 删除books子集合所有文档
    await deleteCollection('users/$userId/books');
    // 2. 删除pdfs子集合所有文档
    await deleteCollection('users/$userId/pdfs');
    // 3. 删除用户主文档
    await FirebaseFirestore.instance.collection('users').doc(userId).delete();
    // 4. 删除Authentication用户记录
    // 如果是当前登录用户删除自己，用currentUser
    final user = FirebaseAuth.instance.currentUser;
    if (user != null && user.uid == userId) {
      await user.delete();
    } else {
      // 如果是管理员删除其他用户，需使用Admin SDK或通过Cloud Functions处理
      // 客户端无法直接删除其他Auth用户，需后端支持
      throw Exception('无法删除非当前登录用户的Auth记录，请通过后端处理');
    }
  } catch (e) {
    print('删除用户数据失败: $e');
    rethrow;
  }
}

扩展方案（若需处理未知子集合） #

如果后续可能新增未知子集合，可采用以下两种方式：

• 方式一：Cloud Functions触发删除
  编写Cloud Functions（使用Admin SDK），监听用户文档的删除事件，在后端自动列出并删除所有子集合：

  // Cloud Functions 代码（Node.js）
  const functions = require('firebase-functions');
  const admin = require('firebase-admin');
  admin.initializeApp();
  
  exports.deleteUserSubcollections = functions.firestore
    .document('users/{userId}')
    .onDelete(async (snap, context) => {
      const userId = context.params.userId;
      const userRef = admin.firestore().collection('users').doc(userId);
      
      // 使用Admin SDK列出所有子集合
      const collections = await userRef.listCollections();
      const deletePromises = collections.map(col => {
        return col.get().then(querySnap => {
          const batch = admin.firestore().batch();
          querySnap.docs.forEach(doc => batch.delete(doc.ref));
          return batch.commit();
        });
      });
      
      await Promise.all(deletePromises);
    });
  

  这样只要删除用户主文档，后端就会自动清理所有子集合。

• 方式二：记录子集合名称到用户文档
  在创建子集合时，将集合名称添加到用户文档的subCollections字段中，比如：

  // 创建子集合时同步记录
  await FirebaseFirestore.instance.collection('users').doc(userId).update({
    'subCollections': FieldValue.arrayUnion(['books'])
  });
  

  删除时读取该字段，遍历删除对应子集合。

注意事项 #

• 确保Firestore安全规则允许用户删除自己的数据，比如：

  match /users/{userId}/{document=**} {
    allow delete: if request.auth != null && request.auth.uid == userId;
  }
  

• 删除Authentication用户时，客户端仅能删除当前登录的用户，删除其他用户需通过Admin SDK或Cloud Functions实现。
• 若子集合中文档数量超过500，需在deleteCollection函数中添加分页逻辑，避免批量操作超限。

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