MongoDB实现查询存在则返回、不存在则创建文档的单操作需求

你原来分两次执行find+insert的方式不仅效率低，还可能在并发场景下出现重复插入的问题。MongoDB提供了原子性的upsert操作，可以一步完成你的需求：

核心解决方案：使用findOneAndUpdate #

这个方法能原子性地完成「查找匹配文档→存在则返回→不存在则插入新文档并返回」的全流程，完美适配你的需求。

Node.js驱动代码示例 #

const targetDoc = await collection.findOneAndUpdate(
  // 1. 查询条件：匹配id为someId1的文档
  { id: "someId1" },
  // 2. 仅当插入新文档时才设置字段（避免修改已有文档）
  { $setOnInsert: { name: "John" } },
  // 3. 配置选项
  {
    upsert: true, // 开启"不存在则插入"的逻辑
    returnDocument: 'after', // 返回操作后的文档（原有文档或新插入文档）
    projection: { _id: 0 } // 可选：排除默认的_id字段，让结果和你的示例格式一致
  }
).then(res => res.value);

console.log(targetDoc);
// 存在时输出：{ id: "someId1", name: "John" }
// 不存在时输出新插入的同结构文档

MongoDB Shell代码示例 #

如果用MongoDB命令行执行，语法略有不同：

db.collection.findOneAndUpdate(
  { id: "someId1" },
  { $setOnInsert: { name: "John" } },
  { 
    upsert: true, 
    returnNewDocument: true, 
    projection: { _id: 0 } 
  }
)

关键参数说明 #

• $setOnInsert：仅在插入新文档时生效的字段设置，确保已有文档的内容不会被修改
• upsert: true：开启upsert模式，是实现"存在则返回，不存在则创建"的核心开关
• returnDocument: 'after'/returnNewDocument: true：指定返回操作完成后的文档，不管是原有的还是新插入的

这样既保证了操作的原子性，又只用一次数据库请求就完成了需求，比你原来的两次操作更高效、更安全。

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