本文详解 Mongoose updateOne 操作中 $push 的正确用法，指出常见参数位置错误，并提供可直接运行的修复方案与最佳实践。

本文详解 mongoose `updateone` 操作中 `$push` 的正确用法，指出常见参数位置错误，并提供可直接运行的修复方案与最佳实践。

在使用 Mongoose 更新文档时，若需向数组字段（如 reactedBy）追加元素，必须将更新操作符（如 $push）与普通字段更新（如 likes: newLikeTotal）统一置于 updateOne 的第二个参数（即 update 对象）中。而原代码中将 $push 错误地作为第三个参数传入，导致该操作被完全忽略——尽管 MongoDB 返回“acknowledged”，但实际未执行任何数组修改。

✅ 正确写法如下：

await Review.updateOne(
  { _id: parsedRequest.id },
  {
    likes: newLikeTotal,
    $push: { reactedBy: user._id }
  }
);

⚠️ 注意事项：

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

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

下载

• updateOne 方法签名是 Model.updateOne(filter, update, options?)，其中 update 必须是一个单个对象，所有更新逻辑（包括 $set、$inc、$push 等）都应在此对象内声明；
• 不要将 $push 与普通字段赋值拆分到不同参数，否则 $push 将被当作无效的 options 被丢弃；
• 若需确保 reactedBy 字段存在且为数组（尤其在首次更新时），可配合 $addToSet 避免重复插入：

  $addToSet: { reactedBy: user._id }

• 启用 new: true 选项（需配合 findOneAndUpdate）可直接返回更新后的文档；updateOne 默认不返回文档，仅返回 { matchedCount, modifiedCount, acknowledged }。

? 补充建议：
为提升健壮性，推荐使用 findOneAndUpdate 并启用 returnDocument: 'after'，同时添加错误处理：

const result = await Review.findOneAndUpdate(
  { _id: parsedRequest.id },
  {
    $inc: { likes: 1 },
    $addToSet: { reactedBy: user._id }
  },
  { returnDocument: 'after', runValidators: true }
);
if (!result) throw new Error('Review not found');

这样既保证原子性，又便于后续逻辑校验与响应。