Mongoose调用findByIdAndUpdate更新未删除未传字段问题

问题根因 #

你遇到的问题核心是Mongoose findByIdAndUpdate 的默认行为逻辑：

• 该方法默认会将你传入的更新对象包装为MongoDB的$set操作，仅修改传入对象中包含的字段，完全不会触碰未传入的字段，因此你没传hobbies、emails、phoneNumbers时，文档中原有值会被保留。
• 直接使用findOneAndReplace会全量替换文档，由于isExecutive未定义在Schema中、也不会从API请求传入，自然会被覆盖丢失，同时该方法还存在非原子操作的并发风险，不适合你的场景。

推荐方案（原子操作，无并发风险） #

通过白名单+手动构造更新操作符的方式实现需求，全程不会触碰isExecutive这类内部维护字段，所有操作在单条Mongo命令中原子执行，不会出现数据不一致：

• 第一步：定义API允许修改的字段白名单，排除_id、employeeId这类不可变字段，以及isExecutive这类内部维护字段
• 第二步：遍历白名单字段，将请求中携带的字段放入$set做覆盖更新（传入空数组、空字符串会直接覆盖原有值），将请求中未携带的字段放入$unset做删除操作
• 第三步：执行更新时开启校验选项，保证Schema定义的长度、格式规则生效

参考实现代码：

// 定义可更新字段白名单，不要把内部字段、不可变字段加入
const ALLOWED_UPDATE_FIELDS = [
  'providerIdentifier',
  'firstName',
  'lastName',
  'hobbies',
  'department',
  'phoneNumbers',
  'emails'
];

// 构造原子更新操作
const buildUpdateOp = (reqBody) => {
  const update = { $set: {}, $unset: {} };
  ALLOWED_UPDATE_FIELDS.forEach(field => {
    if (Object.prototype.hasOwnProperty.call(reqBody, field)) {
      // 请求携带了字段，走覆盖更新，空值/空数组会直接覆盖原有内容
      update.$set[field] = reqBody[field];
    } else {
      // 请求未携带字段，走删除逻辑
      update.$unset[field] = "";
    }
  });
  return update;
};

// 执行更新
const updatedEmployee = await Employee.findByIdAndUpdate(
  targetId,
  buildUpdateOp(req.body.employee),
  {
    new: true, // 返回更新后的文档
    runValidators: true // 开启Schema校验，和save行为一致
  }
);

不推荐方案说明 #

不要使用「先查原文档取出isExecutive，再合并到替换对象后调用findOneAndReplace」的方案：查询和替换是两个独立操作，中间如果Mongo Trigger刚好更新了isExecutive值，替换操作会把新计算的结果覆盖为旧值，导致内部字段数据错误。

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