MongoDB 批量删除数组匹配对象及$pull语法报错的解决方法

你遇到的语法报错和逻辑偏差来自两个核心使用误区：

• $pull操作符的语法完全用错：$pull的设计逻辑是从数组中移除所有满足指定匹配规则的元素，语法结构为{ $pull: { 数组字段: 元素匹配规则 } }，不需要搭配arrayFilters和数组位置占位符（位置占位符是$set/$inc这类局部修改数组元素场景的用法，不适用于$pull）。你原语句中$pull对应的参数写为{ 'friends.$[el]' }，仅写出了带占位符的路径键，没有给数组字段指定明确的删除匹配规则，不仅不符合MongoDB的操作语法，还因为不完整的对象字面量写法，直接触发了JS层面的“missing : after property id”语法解析错误。
• 匹配逻辑和实际删除需求不匹配：你标注需要删除的是name为xyz的两个元素、name为pqr的一个元素，需要保留的是name为abc的元素；但你原写的arrayFilters规则是匹配name在['xyz','abc']范围内的元素，不仅把需要保留的abc纳入了删除范围，还漏了实际要删除的pqr。

通用场景（匹配元素name即删除，无需区分同名下不同age的元素） #

因为$pull会自动遍历整个数组，移除所有符合匹配规则的元素，直接把需要删除的name列表作为匹配条件即可：

db.users.updateOne(
  { name: "Chris" },
  {
    $pull: {
      friends: {
        name: { $in: ["xyz", "pqr"] }
      }
    }
  }
)

执行后Chris的friends数组会仅保留{ "name" : "abc", "age" : 18 }，和你标注的删除预期完全一致。

精准匹配场景（避免同name不同age的元素被误删） #

如果存在同name但age不同的元素，不需要全部删除，可以在匹配规则里补上对应的age条件，精准定位要删除的对象：

db.users.updateOne(
  { name: "Chris" },
  {
    $pull: {
      friends: {
        $or: [
          { name: "xyz", age: { $in: [23, 34] } },
          { name: "pqr", age: 27 }
        ]
      }
    }
  }
)

arrayFilters和数组位置占位符的正确使用场景，是局部修改数组内满足条件的元素值（而非删除整个元素），比如要把friends里所有age大于30的元素的age字段更新为35，这类场景下的写法才是符合语法的：

db.users.updateOne(
  { name: "Chris" },
  { $set: { "friends.$[el].age": 35 } },
  { arrayFilters: [{ "el.age": { $gt: 30 } }] }
)

这种用法和$pull的删除逻辑完全不同，不要混淆两类操作的语法结构。

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