如何在NodeJS脚本中正确使用firebase-tools删除Firestore集合及子集合

看起来你在尝试用Node.js脚本复刻Firebase CLI的递归删除集合功能时，踩了firebase-tools配置的坑。我来帮你梳理问题所在，并给出正确的实现方式。

问题根源分析 #

你遇到的两个错误都是因为对firebase-tools的API使用不正确：

1. 调用firebaseTools.use("my-project")时报错，是因为这个方法接收的是配置对象而非字符串，它无法在字符串上添加project属性。
2. 移除该语句后报错，是因为firebase-tools不知道要操作哪个项目，必须明确指定项目ID。

另外，你传递给firebaseTools.firestore.delete()的是Firestore的CollectionReference对象，但这个方法实际需要的是集合的路径字符串（比如"fruits"）。

正确实现代码 #

下面是可以完美实现你需求的脚本，完全对应CLI命令firebase -P my-project firestore:delete fruits --recursive的效果：

const admin = require("firebase-admin");
const serviceAccount = require("path_to_my_service_account_key.json");
const firebaseTools = require("firebase-tools");

// 初始化Firebase Admin SDK（确保认证权限）
admin.initializeApp({
  credential: admin.credential.cert(serviceAccount),
  databaseURL: `https://my-project.firebaseio.com`,
});

async function deleteCollection(collectionName) {
  try {
    // 调用firebase-tools的删除方法，传入路径和配置选项
    const deleteResult = await firebaseTools.firestore.delete(collectionName, {
      project: "my-project", // 指定要操作的项目ID
      recursive: true,       // 开启递归删除子集合，对应CLI的--recursive
      yes: true,             // 跳过交互确认，脚本环境下必须设置
      credential: admin.credential.applicationDefault() // 复用Admin SDK的认证
    });
    console.log("删除操作执行成功:", deleteResult);
  } catch (error) {
    console.error("删除操作失败:", error);
  }
}

// 执行删除
deleteCollection("fruits");

关键配置说明 #

• 指定项目ID：直接在delete方法的options里传入project字段，这比用firebaseTools.use()更直观，也避免了配置对象的错误。
• 递归删除：必须添加recursive: true，否则只会删除集合里的文档，不会处理子集合。
• 跳过交互确认：脚本无法像CLI那样等待用户输入确认，所以要加上yes: true自动确认删除。
• 认证权限：通过credential选项复用Admin SDK的认证信息，确保脚本拥有足够的权限删除Firestore数据（你的服务账号需要具备Firestore的删除权限，比如分配Firebase Admin角色）。

额外注意事项 #

确保你已经安装了firebase-tools依赖：

npm install firebase-tools --save

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