如何删除Firebase嵌套集合文档内数组中的指定数据项

架构老林

2026-9-27

Firestore 嵌套文档数组指定项删除实现方案

方案1：使用内置 `arrayRemove` 方法（适合已知完整数组项内容的场景）

Firestore 提供了原生的数组删除操作符，可以直接匹配并删除数组中的指定元素，不需要先读取文档：

import { arrayRemove, updateDoc } from "firebase/firestore";

// 你已获取的目标文档引用
const pedidoDocRef = db.collection("usuarios").doc(user.uid).collection("pedidos").doc(id);
// 填入待删除的完整数组项，需和存储的内容完全一致
const toDeleteItem = {
  id: "L-2627",
  // 其他数组项原有的字段，必须和存储时完全匹配才能被识别
};

await updateDoc(pedidoDocRef, {
  data: arrayRemove(toDeleteItem)
});

注意：`arrayRemove` 是精确匹配规则，如果数组内是对象结构，仅传ID字段无法匹配到目标项，需要传入完整的对象内容

方案2：读取后过滤再更新（适合仅知道待删除项ID的场景）

如果你的数组项字段多、或者你无法拿到完整的待删除项内容，可以先读取文档内容，过滤掉目标ID对应的项后再覆盖更新数组：

import { getDoc, updateDoc } from "firebase/firestore";

const pedidoDocRef = db.collection("usuarios").doc(user.uid).collection("pedidos").doc(id);
const deleteId = "L-2627"; // 你拿到的待删除项唯一ID

const docSnapshot = await getDoc(pedidoDocRef);
if (docSnapshot.exists()) {
  const docData = docSnapshot.data();
  // 过滤生成删除后的新数组
  const newDataArray = docData.data.filter(item => item.id !== deleteId);
  // 覆盖更新文档的数组字段
  await updateDoc(pedidoDocRef, {
    data: newDataArray
  });
  // 操作完成后可同步更新 Local Storage 和 Material UI DataGrid 的数据源，无需重新拉取全量数据
}