Mongoose文档操作：按邮箱查询，存在则更新_id，不存在则创建

嘿，我来帮你搞定这个Mongoose的upsert需求！先梳理下你的核心诉求：通过用户邮箱查询文档，找到的话更新它的_id字段，找不到就创建包含指定姓名、邮箱的新用户。不过先提个小提醒：MongoDB的_id是文档的主键，修改已存在文档的_id属于非常规操作，可能会破坏关联数据或索引，建议确认业务是否真的需要这么做哦。

原代码的问题点 #

先看你给出的代码片段，有两个明显的问题：

• 拼写错误：profil...应该是profile，这会导致查询条件失效
• 逻辑不够严谨：直接创建newUser后就用它的_id去更新，没有区分“更新现有文档”和“创建新文档”的字段赋值逻辑

修正后的完整代码 #

下面是调整后的可运行代码，我会逐行解释关键逻辑：

function (accessToken, refreshToken, profile, done) {
  // 1. 定义查询条件：精准匹配用户邮箱
  const query = { email: profile.emails[0].value.toString() };

  // 2. 定义更新规则：区分更新和插入场景
  const update = {
    // 仅对已存在的文档生效：更新其_id字段
    $set: { _id: new mongoose.Types.ObjectId() },
    // 仅对新插入的文档生效：设置姓名和邮箱
    $setOnInsert: {
      name: profile.displayName,
      email: profile.emails[0].value.toString()
    }
  };

  // 3. 配置upsert选项
  const options = {
    upsert: true,        // 开启「存在更新，不存在创建」逻辑
    new: true,           // 返回操作后的最新文档
    setDefaultsOnInsert: true // 插入新文档时应用Schema定义的默认值
  };

  // 4. 执行查询并处理结果
  User.findOneAndUpdate(query, update, options)
    .then(updatedUser => done(null, updatedUser))
    .catch(err => done(err, null));
}

关键逻辑说明 #

• 查询条件：用profile.emails[0].value.toString()确保邮箱格式是字符串，避免类型不匹配导致的查询失败
• 更新规则：
  • $set：专门处理已存在文档的_id更新（如果你不需要手动生成_id，可以去掉这个，MongoDB会自动维护主键唯一性）
  • $setOnInsert：只在创建新文档时赋值name和email，这样不会覆盖已有文档的其他字段
• 选项配置：upsert: true是实现需求的核心开关，new: true让你拿到的是操作后的最新文档，setDefaultsOnInsert: true确保新文档会继承Schema里的默认字段值

额外注意事项 #

如果你只是想在创建新文档时指定_id，而不是更新已有文档的_id，可以把$set里的_id移到$setOnInsert中，这样就不会修改已有文档的主键了，这也是更推荐的做法：

const update = {
  $setOnInsert: {
    _id: new mongoose.Types.ObjectId(), // 仅新文档指定_id
    name: profile.displayName,
    email: profile.emails[0].value.toString()
  }
};

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