本文详解 Mongoose updateOne 操作中 $push 的正确用法，指出常见参数位置错误，并提供可直接运行的修复方案与最佳实践。
本文详解 mongoose `updateone` 操作中 `$push` 的正确用法，指出常见参数位置错误，并提供可直接运行的修复方案与最佳实践。
在使用 Mongoose 进行文档更新时，一个高频误区是误将更新操作符（如 $push）置于 updateOne 的第三个参数（即选项对象）中，而非作为更新操作体的一部分。这会导致操作被静默忽略——MongoDB 服务端返回“acknowledged”，但实际未执行数组推送。
你提供的代码：
问题根源在于：updateOne(filter, update, options) 的
第二个参数 update 必须包含所有修改操作
（包括字段赋值和原子操作符），而第三个参数仅用于控制行为（如 new: true、upsert 等），
不支持任何更新操作符
。因此 $push 放在第三位将被完全忽略。
✅ 正确写法应将 $push 与普通字段更新合并至第二个参数中：
? 补充说明：若需确保 reactedBy 字段存在且为数组（尤其在首次更新时），可配合 $addToSet 避免重复添加：
此外，请确认 Schema 定义中 reactedBy 的默认值写法无歧义。当前定义：
应修正为：
否则可能引发初始化异常或类型校验问题。
最后，建议启用 Mongoose 的调试日志以验证实际发送的命令：
它会输出真实执行的 MongoDB 命令，便于快速定位更新逻辑是否按预期构造。
总结：$push 等更新操作符必须位于 updateOne 的第二个参数内；Schema 中数组字段的 default 需定义在字段层级而非子项层级；善用 debug 模式可显著提升排查效率。
await Review.updateOne(
{ _id: parsedRequest.id },
{ likes: newLikeTotal },
{ $push: { reactedBy: user._id } } // ❌ 错误：$push 被放在 options 参数中
)await Review.updateOne(
{ _id: parsedRequest.id },
{
likes: newLikeTotal,
$push: { reactedBy: user._id }
}
);$addToSet: { reactedBy: user._id }reactedBy: [{
required: true,
type: mongoose.Types.ObjectId,
ref: "User",
default: [] // ⚠️ 此处 default 写法无效：数组字段的 default 应设在数组本身层级
}]reactedBy: {
type: [{
type: mongoose.Types.ObjectId,
ref: "User"
}],
required: true,
default: [] // ✅ default 作用于数组字段整体
}mongoose.set('debug', true);