优先用$pull按条件删除数组元素，$pullAll仅适用于已知固定值；二者均不自动删除字段，空数组需配合$unset或聚合管道清理，且须注意类型匹配、索引优化与multi设置。
删除数组中满足条件的单个或多个元素用 $pull
当你要根据字段值、嵌套条件或表达式删掉数组里部分匹配的元素时，$pull 是最常用也最灵活的选择。它不是按索引删，而是按“内容匹配”删，适合业务逻辑驱动的清理场景。
常见错误是误以为 $pull 能删整个子文档的一部分字段——它只删整个数组项；另一个坑是没注意类型匹配，比如字符串 "123" 和数字 123 不会匹配。
- 基本写法：
{ $pull: { "tags": "urgent" } }—— 删掉tags数组中所有等于字符串"urgent"的元素 - 匹配子文档：
{ $pull: { "comments": { "author": "alice", "score": { $gt: 3 } } } }—— 删掉comments中同时满足两个条件的完整对象 - 配合操作符：
{ $pull: { "scores": { $in: [95, 98] } } }—— 删除数组中所有出现在指定列表里的值
批量删除多个已知值用 $pullAll
$pullAll 更适合你已经明确知道要删哪些具体值的情况，比如从权限数组里一次性移除几个固定角色。它内部是做精确值比对（=== 语义），不支持查询操作符（如 $gt、$regex），这点和 $pull 有本质区别。
容易踩的坑：传入的值必须和数组中存储的类型、结构完全一致。比如数组存的是 ObjectId，你就不能传字符串形式的 ID；如果数组里是对象，传一个字段少的对象也不会匹配。
- 正确示例：
{ $pullAll: { "roles": ["admin", "editor"] } }—— 假设roles是字符串数组 - 对象数组慎用：
{ $pullAll: { "items": [{ "id": 1, "name": "A" }] } }只有当数组中存在**完全相同结构和值**的对象才会被删 - 不支持动态条件：
$pullAll后面不能跟{ $gt: 10 }这类表达式，否则报错Unknown operator: $gt
删除后数组为空，字段还存在吗？
默认情况下，即使 $pull 把数组删成空数组 []，该字段依然保留在文档中。MongoDB 不会自动删除字段，除非你显式用 $unset 配合使用。
这在某些聚合或校验逻辑里可能引发意外：比如你假设某个字段存在就代表有数据，但其实它只是个空数组。需要特别留意业务代码是否做了空数组防御。
- 保留空数组（默认行为）：
{ $pull: { "history": { "status": "draft" } } } - 删完清空字段：
{ $pull: { "history": { "status": "draft" } }, $unset: { "history.$": "" } }—— 注意$unset用history.$只能清当前匹配位置，清整个字段得用history: "" - 更稳妥的清空字段方式：
{ $pull: { "history": { "status": "draft" } }, $set: { "history": { $cond: { if: { $eq: [{ $size: "$history" }, 0] }, then: "$$REMOVE", else: "$history" } } } }（需 MongoDB 4.2+，在 update 中用聚合管道）
性能与更新安全：别忽略 multi 和索引
$pull 和 $pullAll 默认只更新第一个匹配文档，除非你显式设置 { multi: true }（Node.js 驱动里是 multi: true 或新版的 updateMany）。漏掉这个会导致你以为删了一堆，其实只动了第一条。
另外，如果数组很大且匹配条件较宽泛（比如 { "tags": "deprecated" } 出现在百万级文档中），没有对应索引的话，每次更新都可能触发全表扫描。建议对高频被 $pull 查询的数组字段建多键索引。
- 确保批量生效：
db.collection.updateMany({ status: "archived" }, { $pull: { "events": { "type": "temp" } } }) - 加索引提升速度：
db.collection.createIndex({ "events.type": 1 })—— 多键索引会自动展开数组 - 注意写锁影响：大数组的
$pull操作可能持有文档锁更久，高并发下留意延迟毛刺
实际用的时候，多数情况优先选 $pull；只有确定要删的值完全固定、数量不多，才考虑 $pullAll。最麻烦的往往不是语法，而是删完之后空数组是否被下游系统当成“有数据”来处理。
