Node.js使用findByIdAndUpdate无法更新MongoDB文档求助

问题场景 #

在Node.js环境下使用Mongoose更新MongoDB文档，代码如下：

var id = data[0]._id;

var updated = {
    level: mod.level,
    levelName: mod.levelName,
    levelType: mod.levelType,
    map: mod.map,
    waves: mod.waves
};

model.findByIdAndUpdate(id, updated, function(err, data){
    if(err){
        console.log('error');
        console.log(err);
        res.send(err);
    } else {
        console.log('update');
        console.log(data);
        res.send({ data: 'Record has been updated' });
    }
});

执行时进入else分支，打印出update日志，但data为null，且数据库中文档未被修改。对应的Schema定义：

var Schema = mongo.Schema;

var LevelSchema = new Schema({
    level: { type: String },
    levelName: { type: String },
    levelType: { type: String },
    map: { type: Object },
    waves: { type: Object }
}, { versionKey: false });

解决方法 #

• 添加{new: true}选项
  旧版Mongoose的findByIdAndUpdate默认返回更新前的文档，若未匹配到目标文档则返回null。添加{new: true}后会返回更新后的文档，同时能直观确认是否成功匹配并修改：

  model.findByIdAndUpdate(id, updated, {new: true}, function(err, data){
      // 原有逻辑不变
  });
  

• 验证id的有效性
  确认data[0]._id是合法的MongoDB ObjectId。如果是字符串格式，需先转换为ObjectId类型：

  const mongoose = require('mongoose');
  var id = mongoose.Types.ObjectId(data[0]._id);
  

  同时检查data[0]是否来自有效的查询结果，确保_id对应数据库中存在的文档。

• 检查更新内容的有效性
  若mod对象的所有字段值为undefined，或与原文档完全一致，Mongoose不会执行更新操作。更新前打印updated对象确认存在实际修改内容：

  console.log('待更新内容:', updated);
  

• 开启调试日志定位问题
  启用Mongoose调试模式，查看实际发送给MongoDB的命令，确认查询条件和更新内容是否正确：

  mongoose.set('debug', true);
  

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