删除Firebase Storage用户文件夹触发StorageException异常问题

问题根源 #

• Firebase Storage里的「文件夹」是虚拟概念，并非实际存储的对象，它只是文件路径的一部分。当路径下所有文件都被删除后，这个“文件夹”会自动消失，不存在单独的文件夹对象可以删除。
• 你的代码用then处理异步文件删除，但主线程不会等文件删完就立刻执行profilePhotoRef.delete()，这时候要么文件还未删除完成，要么文件夹已经因文件清空而“消失”，导致删除操作触发404错误。
• 循环删除文件时未等待每个delete()完成，可能出现文件未删完就执行后续操作的情况。

解决方法 #

方案1：删除所有文件即可，无需手动删文件夹

既然文件夹是虚拟的，只要删光路径下所有文件，这个“文件夹”就自动不存在了，完全不需要调用profilePhotoRef.delete()。用async/await确保所有操作按顺序执行：

// Delete Profile Photo
try {
  final profilePhotoRef = FirebaseStorage.instance.ref().child('images/${user.uid}');
  // 等待获取所有文件列表
  final value = await profilePhotoRef.listAll();
  // 等待每个文件删除完成
  for (var element in value.items) {
    await element.delete(); // 直接用element的delete方法，无需重新生成ref
  }
  print("所有文件删除完成，虚拟文件夹已自动移除");
} on FirebaseException catch (e) {
  print("Failed with error '${e.code}': ${e.message}");
}

方案2：保留删除文件夹操作，捕获预期异常忽略

如果坚持要调用删除文件夹的代码，可以专门捕获object-not-found异常并忽略（该异常是预期的，因为文件夹本身不存在）：

// Delete Profile Photo
try {
  final profilePhotoRef = FirebaseStorage.instance.ref().child('images/${user.uid}');
  final value = await profilePhotoRef.listAll();
  for (var element in value.items) {
    await element.delete();
  }
  // 尝试删除文件夹，捕获不存在的异常
  try {
    await profilePhotoRef.delete();
  } on FirebaseException catch (e) {
    if (e.code == 'object-not-found') {
      // 文件夹已自动消失，忽略该异常
      print("虚拟文件夹已不存在，无需删除");
    } else {
      rethrow; // 其他异常抛出处理
    }
  }
} on FirebaseException catch (e) {
  print("Failed with error '${e.code}': ${e.message}");
}

关键注意点 #

• 处理Firebase Storage异步操作时，必须用async/await替代then，确保操作按顺序执行，避免异步竞态问题。
• 永远记住Firebase Storage没有真实的文件夹，不要把它当成本地文件系统的文件夹来操作。

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