MongoDB中如何利用$push配合$each进行批量数组更新？

作者：袖梨 2026-07-07

$push + $each 报错“cannot apply $each modifier to non-array”是因为目标字段必须是数组类型，若字段不存在、为null、string或number等非数组值，MongoDB会拒绝操作；安全做法是预先用$set初始化为空数组或用$setOnInsert确保字段存在。

为什么$push + $each 会报错 "cannot apply $each modifier to non-array"？

直接对一个不存在或值为 null、string、number 的字段执行 $push 配合 $each，MongoDB 会拒绝操作并抛出该错误。它要求目标字段必须是数组类型，且不能是 undefined 或其他非数组值。

常见触发场景：文档首次插入时没初始化数组字段；或者之前用 $set 覆盖成了非数组值。

安全做法：更新前确保字段存在且为数组，可用 $setOnInsert 或先执行一次 $set: { tags: [] }
更稳妥的写法是结合 $ifNull 在聚合管道式更新（4.2+）中做类型兜底，但普通 updateOne 不支持
如果不确定字段状态，建议先用 find 查看实际值，或用 $addToSet 替代（但不保证顺序、去重）

如何正确使用 $push + $each 插入多个元素并保持顺序？

$each 是 $push 的子修饰符，用于指定要追加的元素列表，MongoDB 会按数组顺序逐个追加到目标数组末尾，顺序严格保留。

示例：给用户文档的 history 数组一次性添加三条操作记录：

db.users.updateOne(  { _id: ObjectId("...") },  { $push: { history: { $each: [      { action: "login", at: ISODate("2024-05-01T08:00:00Z") },      { action: "view", at: ISODate("2024-05-01T08:05:00Z") },      { action: "search", at: ISODate("2024-05-01T08:10:00Z") }    ] } } })

$each 必须嵌套在 $push 对象内，不能平级写成 { $push: ..., $each: [...] }
所有元素类型需一致（如全是对象或全是字符串），否则虽不报错但可能引发后续查询逻辑混乱
若目标数组已有内容，新元素一定追加在末尾；不支持“插入到开头”——那得用 $each 配合 $position: 0

$position 和 $slice 如何与 $each 协同控制数组大小和位置？

$position 指定插入位置索引（从 0 开始），$slice 控制最终数组长度，二者可同时与 $each 共存，实现“头部插入 + 保底截断”等策略。

例如：只保留最近 5 条日志，新日志插到开头：

db.logs.updateOne(  { _id: 123 },  { $push: {      entries: {        $each: [ { msg: "new error" } ],        $position: 0,        $slice: -5      }    }  })

$position: 0 表示插入到索引 0 位置（即最前面）；负数索引不支持
$slice: -5 表示保留最后 5 项（即从尾部截取）；$slice: 5 是保留前 5 项
注意：$position 和 $slice 必须和 $each 在同一层级，都属于 $push 的子对象
如果只用 $slice 而不用 $each，则仅做截断，不新增元素

在 Node.js 驱动里传入 $each 时要注意什么？

Node.js MongoDB 驱动（v4.0+）本身不修改你传入的 JS 数组，但容易因引用或变量复用导致意外行为。

避免复用同一个数组变量多次调用 $push，比如 const items = [...]; update(..., { $each: items }) → 后续修改 items 会影响下一次更新内容
如果元素含日期或 ObjectId，确保它们是原生 Date 或 ObjectId 实例，而非字符串；驱动不会自动转换
使用 updateMany 批量更新时，$each 内容对每个匹配文档都相同；如需差异化数据，必须用 bulkWrite 分条构造