Mongoose pre-update hook触发后fullName修改未同步至数据库

• 两类Mongoose钩子的上下文存在本质差异，是你写的更新逻辑不生效的根本原因：
  • pre('save')属于文档级钩子，回调内的this指向当前待持久化的文档实例，你直接给实例的属性赋值，会随文档一起写入数据库，这也是你之前用pre-save钩子更新fullName完全正常的原因。
  • pre('updateOne')/pre('update')属于查询级钩子，回调内的this指向当前执行的Query构造器实例，根本不是待更新的文档对象。你在钩子里写的this.fullName = newFullName、this.middleName = update['middleName']这类赋值，本质都是给Query对象挂了临时自定义属性，这些属性完全不会被Mongoose拼接成最终发给MongoDB的更新语句，自然不会同步到数据库。
• 你对middleName能正常更新的判断存在完全的认知偏差：
  你调用updateOne时，请求体里的middleName本来就已经被放进$set参数里传给Mongoose了，哪怕你把钩子里那行给middleName赋值的代码全删掉，数据库里的middleName字段也会正常更新。你在控制台看到的正确打印值，只是你给Query对象临时挂的自定义属性的输出，和实际执行的数据库更新逻辑没有任何关系。
• fullName始终不更新的原因非常直接：
  你调用接口时传给$set的参数里根本没有fullName字段，你在钩子里给Query对象挂的fullName属性又不会自动合并到$set更新规则里，自然数据库里的fullName永远不会变化，也不会抛出任何错误——毕竟Mongoose根本没识别到你要更新这个字段。

要在查询级更新钩子里修改更新内容，必须直接操作Query对象官方暴露的更新参数，而不是给Query实例随便挂自定义属性。修正后的pre钩子代码如下：

// 覆盖所有常见的更新方法触发规则
Contact.pre(/^(updateOne|update|findOneAndUpdate)/, function (next) {
  // 获取当前query已设置的$set更新规则
  const setUpdate = this.getUpdate().$set || {};

  // 优先取本次更新的firstName/lastName，如果本次请求没传这两个字段，就从查询条件里获取原有值做兜底
  const newFirstName = setUpdate.firstName ?? this.getQuery().firstName;
  const newLastName = setUpdate.lastName ?? this.getQuery().lastName;

  // 把计算好的fullName直接塞进$set更新规则，才会真正被传到数据库执行更新
  setUpdate.fullName = `${newFirstName || ''} ${newLastName || ''}`.trim();

  // 把修改后的更新规则回写到query对象
  this.setUpdate({ $set: setUpdate });

  next();
});

• 不要直接操作this._update这类Mongoose的内部私有字段，不同版本的Mongoose可能会调整内部属性命名，使用官方提供的getUpdate()/setUpdate()方法操作稳定性最高。
• 要做好字段兜底逻辑：如果本次更新只修改了middleName没有改动firstName/lastName，直接从$set里取这两个字段会拿到undefined，拼出来的fullName会变成空字符串覆盖原有值，必须从查询源获取原有字段值做防护。
• 注意钩子的匹配规则覆盖范围：如果业务里用到了findOneAndUpdate这类更新方法，需要把对应的方法名加进正则匹配规则里，不然钩子不会触发。

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