为何Mongoose中updateOne()无法更新MongoDB文档的所有字段？

我尝试用Mongoose对MongoDB文档执行PATCH更新，先获取现有文档：

const ratePlan = await RatePlan.findOne({
  _id: req.params.id,
})

以下两种方式能正常用req.body更新所有字段（包括对象数组）：

// 方式一：修改文档实例后保存
for (const [key, value] of Object.entries(req.body)) {
  ratePlan[key] = value
}
await ratePlan.save()

// - OR -

// 方式二：全量替换文档
await RatePlan.replaceOne(
  { _id: ratePlan._id },
  {
    ...ratePlan.toObject(),
    ...req.body,
  },
  {
    overwriteDiscriminatorKey: true,
    runValidators: true,
  },
)

但使用updateOne时，仅能更新文本、数值类字段，无法更新parent类型特有的对象数组字段：

await RatePlan.updateOne({ _id: ratePlan._id }, req.body, {
  overwriteDiscriminatorKey: true,
  runValidators: true,
})

核心原因分析 #

1. Schema严格模式的过滤机制
   Mongoose默认开启strict: true模式，会自动过滤掉当前模型Schema中未定义的字段。RatePlan是基类模型，而无法更新的对象数组字段仅存在于parent discriminator的Schema中，基类Schema没有该字段定义。因此用基类模型RatePlan调用updateOne时，req.body中的该字段会被Mongoose判定为“非法字段”直接过滤，不会发送到MongoDB执行更新。

2. 三种更新方式的本质差异

• 文档实例修改后save：获取到的ratePlan是parent类型的实例，绑定了parent的Schema，strict模式会基于parent的Schema验证字段，因此该对象数组字段是合法的，save时会正确提交所有修改。
• replaceOne全量替换：通过...ratePlan.toObject()获取了parent类型的完整文档结构，合并req.body后执行全量替换，加上overwriteDiscriminatorKey: true的配置，Mongoose会识别出目标文档是parent类型，使用parent的Schema处理，不会过滤该字段。
• updateOne直接更新：基于基类RatePlan的Schema处理更新请求，parent特有的字段不在基类Schema中，被strict模式过滤，因此无法更新。

可选解决办法 #

如果要使用updateOne实现更新，需要通过parent discriminator模型而非基类模型调用，并明确使用$set操作：

// 假设ParentRatePlan是parent类型的discriminator模型
await ParentRatePlan.updateOne(
  { _id: ratePlan._id },
  { $set: req.body },
  { runValidators: true }
)

内容的提问来源于stack exchange，提问作者Mike