Mongoose 中使用 $push 正确更新数组字段的完整指南-js教程-PHP中文网

Mongoose 中使用 $push 正确更新数组字段的完整指南

本文详解 Mongoose updateOne 中 $push 操作符的正确用法，指出常见参数位置错误，并提供可直接复用的代码示例与关键注意事项。

本文详解 mongoose `updateone` 中 `$push` 操作符的正确用法，指出常见参数位置错误，并提供可直接复用的代码示例与关键注意事项。

在使用 Mongoose 对嵌套数组字段（如 reactedBy）执行追加操作时，一个高频错误是误将 $push 放在 updateOne 的第三个参数（即 options 对象）中。正如问题所示，以下写法无效且被静默忽略：

// ❌ 错误：$push 被当作 options 传入，不会生效
await Review.updateOne(
  { _id: parsedRequest.id },
  { likes: newLikeTotal },
  { $push: { reactedBy: user._id } } // ← 这里是 options，不是 update 操作符！
);

正确的做法是：所有更新操作符（如 $push、 $set、 $inc）必须统一放在 updateOne 的第二个参数（即 update document）中，与普通字段更新并列：

// ✅ 正确：$push 与 likes 同属 update 对象
await Review.updateOne(
  { _id: parsedRequest.id },
  {
    likes: newLikeTotal,
    $push: { reactedBy: user._id }
  }
);

此外，为确保数据一致性与健壮性，建议补充以下实践：

启用 new: true 获取更新后文档（如需返回结果）：

使用Go语言搭建家庭相册系统-相关课件

下载

const updatedReview = await Review.findOneAndUpdate(
  { _id: parsedRequest.id },
  {
    $inc: { likes: 1 },
    $push: { reactedBy: user._id }
  },
  { new: true, runValidators: true }
);

避免重复添加：若需防止同一用户多次 push，可结合 $addToSet（自动去重）：
```
$addToSet: { reactedBy: user._id }
```
注意 Schema 定义细节：您当前 schema 中 reactedBy 数组项的 default: [] 是冗余的（数组本身默认为空），且 required: true 应作用于整个数组字段而非数组元素（除非业务强制要求非空数组）。推荐修正为：
```
reactedBy: [{
  type: mongoose.Types.ObjectId,
  ref: 'User',
  // required: true  // ← 若允许空数组，此处不应设为 required
}]
```