$pull 不生效主因是匹配条件不严格：仅完全匹配数组元素，不支持模糊查找、正则或嵌套路径；删对象需全字段匹配或用查询操作符；嵌套数组须用 $[]；空数组需手动 $unset。
为什么 $pull 有时不生效？检查匹配条件是否严格
MongoDB 的 $pull 操作只删除完全匹配的数组元素，不是模糊查找或字段部分匹配。比如数组里存的是对象 {name: "Alice", score: 85}，你用 {$pull: {tags: "high"}}} 是删不掉的——除非 tags 是字符串数组且真有 "high" 这个值。
常见错误现象：
- 删除后数组长度没变
- 日志显示匹配了 0 个文档
- 误以为
$pull支持正则或子字段路径匹配（它不支持，$pull后面跟的必须是数组字段本身）
使用场景注意：
- 如果数组元素是对象，必须提供完整键值对（或用查询操作符如
$eq、$in） - 若只想按某个字段删（如所有
status: "inactive"的对象），得用$pull配合对象查询：{$pull: {items: {status: "inactive"}}}
db.users.updateOne(
{_id: 1},
{$pull: {roles: {name: "editor", level: 2}}}
)
批量删多个值？用 $in 比写多次 $pull 更快
反复调用 $pull 删除不同值（比如先删 A，再删 B）会触发多次文档读取与重写，性能差，还可能因并发导致中间状态残留。
正确做法是把要删的值归到一个集合里，用 $in 一次清空：
- 字符串/数字数组：直接
{$pull: {tags: {$in: ["beta", "test"]}}} - 对象数组：必须确保每个对象结构一致，或改用
$or（但注意$pull不支持顶层$or，得包装成{$pull: {items: {$or: [{type: "A"}, {type: "B"}]}}}）
性能影响：
-
$in列表不宜过长（建议 ≤ 100 项），否则 BSON 大小超限或查询计划退化 - 如果数组极大（如万级元素），
$pull仍需遍历整个数组字段，没有索引加速
嵌套数组怎么删？$pull 不支持多层点号路径
这是高频踩坑点：$pull 只作用于直接子数组字段，不能写 comments.replies 这种路径。例如文档结构是：
{
comments: [
{ text: "ok", replies: ["a", "b"] },
{ text: "no", replies: ["c"] }
]
}
你想删所有 replies 中的 "a"，{$pull: {"comments.replies": "a"}} 无效——MongoDB 会静默忽略该操作。
可行解法：
- 用
$[]位置操作符（4.2+）：{$pull: {"comments.$[].replies": "a"}} - 或升级到 5.0+ 用
$[带过滤的更新器，更精准控制范围] - 旧版本只能应用端拉取、修改、全量写回，或者改用聚合管道更新（
updateOne+pipeline）
兼容性提醒：
-
$[]在 3.6 引入，但仅支持无条件全量匹配；带条件的$[elem]是 3.6+ 要求arrayFilters配合 - 错误信息
Path collision往往就是误用了点号嵌套路径
删完要不要校验？数组字段可能残留 null 或空对象
$pull 本身不会清理字段，如果数组被删空，字段依然存在（值为 []）。某些业务逻辑依赖“字段不存在”语义，这时需要额外步骤：
- 空数组后自动删字段：用
$unset配合$expr判断长度，但需两步 update（先$pull，再查size: 0后$unset） - 更稳妥的做法是在应用层判断：执行
$pull后，用find检查目标数组长度，必要时补$unset
容易被忽略的地方：
- 使用
multi: true时，每个匹配文档都独立执行$pull，但不会跨文档聚合统计 - 如果数组元素含
ObjectId、Date等类型，务必确认传入的值类型一致（字符串形式的 ObjectId ≠ ObjectId 实例） -
$pull不触发 TTL 索引行为，也不会影响其他字段的变更流事件内容
