Firebase Storage删除文件夹报错：storageRef.listAll is not a function

问题 #

在Firebase Storage中删除整个文件夹时遇到问题，指定路径引用后调用storageRef.listAll()时始终报错storageRef.listAll is not a function，希望删除该完整路径下所有可能存在的图片。

相关代码：

const storage = getStorage();

const storageRef = ref(
  storage,
  `${aktuellerUser._id}/artikelBilder/`
);

storageRef
  .listAll()
  .then((listResults) => {
    const promises = listResults.items.map((item) => {
      return item.delete();
    });
    Promise.all(promises);
  })
  .catch((error) => {
    console.log(error);
  });

报错信息：

error TypeError: storageRef.listAll is not a function

解决方案 #

你用的是Firebase v9及以上的模块化API，listAll不是存储引用对象的方法，而是独立的顶层函数，得单独导入后使用：

1. 先导入所需的Firebase Storage函数：

import { getStorage, ref, listAll, deleteObject } from "firebase/storage";

2. 修改原代码，改用顶层函数调用：

const storage = getStorage();
const storageRef = ref(storage, `${aktuellerUser._id}/artikelBilder/`);

listAll(storageRef)
  .then((listResults) => {
    const promises = listResults.items.map((itemRef) => {
      return deleteObject(itemRef);
    });
    return Promise.all(promises); // 必须return，否则无法追踪异步操作完成状态
  })
  .then(() => {
    console.log("文件夹下所有文件已删除");
  })
  .catch((error) => {
    console.error("删除文件失败:", error);
  });

几个关键注意点：

• Firebase v9+采用模块化API设计，大部分操作都是通过顶层函数实现，不再挂载在引用对象上
• 原代码里Promise.all(promises)没有return，导致无法得知所有文件是否删除完成，建议加上return并通过后续then处理完成逻辑
• 要确保Firebase SDK已正确安装和初始化，且Storage权限规则允许读取和删除该路径下的文件

内容的提问来源于stack exchange，提问作者Captai-N