MongoDB嵌套对象更新：如何在Schema中校验非法更新并保留未传字段？

问题背景 #

现有MongoDB嵌套Schema定义如下：

rating: {
      average: {
        type: Number,
        default: 4.5,
        min: [1, 'Rating must be above 1.0'],
        max: [5, 'Rating must be below 5.0'],
        set: (val) => Math.round(val * 10) / 10, // 4.666666 → 4.7
      },
      count: {
        type: Number,
        default: 0,
      },
    }

当发送更新请求 {"rating": 6} 时，嵌套对象被非法修改，以下是针对两个问题的解决方案：

1. 如何在Schema本身中对嵌套对象的非法更新进行校验？ #

要实现Schema层面的校验，需完成以下两点：

• 启用更新校验器：Mongoose默认在update操作时不执行Schema校验规则，必须在updateOne、findByIdAndUpdate等更新方法中添加runValidators: true选项，触发字段的min/max等校验逻辑。
• 限制rating字段类型：当前Schema未明确限制rating的类型，导致可直接赋值数字。需给rating字段添加type: Object约束，还可加自定义校验器防止非对象赋值：

  rating: {
    type: Object, // 明确约束为对象类型
    validate: {
      validator: function(v) {
        return typeof v === 'object' && v !== null;
      },
      message: 'Rating must be an object containing average and count fields'
    },
    default: () => ({
      average: 4.5,
      count: 0
    }),
    // 嵌套字段定义保持不变
    average: { 
      type: Number,
      default: 4.5,
      min: [1, 'Rating must be above 1.0'],
      max: [5, 'Rating must be below 5.0'],
      set: (val) => Math.round(val * 10) / 10,
    },
    count: {
      type: Number,
      default: 0,
    },
  }
  

  结合runValidators: true后，若请求传入{"rating":6}会触发类型校验报错；若传入{"rating.average":6}，则会触发average字段的max校验。

2. 如何确保不更新未在请求中提供的字段？ #

核心是避免直接替换整个嵌套对象，采用原子更新策略：

• 使用$set操作符：更新时仅修改传入的具体字段，而非覆盖整个rating对象。例如请求传入{"rating.average": 4.7}，更新代码应写为：

  await Model.findByIdAndUpdate(
    id,
    { $set: req.body }, // 仅更新请求中存在的字段
    { runValidators: true, new: true }
  );
  

  这样仅会修改rating.average，rating.count会保留原有值，不会被覆盖。
• 依赖strict模式：Mongoose默认strict: true，会忽略Schema中未定义的字段。若需要更严格控制，可在更新时设置strict: 'throw'，传入未定义字段时直接报错。
• 禁止直接赋值整个嵌套对象：永远不要写{ rating: req.body.rating }，这会覆盖整个rating对象，导致未传入的字段（如count）被替换为默认值或丢失，必须用$set针对具体子字段更新。

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