Node.js中MongoDB原子findOrCreate方法问题：查对象不存在则创建

嘿，这个问题我之前折腾过好一会儿，终于找到正确的姿势了！核心就是用findOneAndUpdate但要配对参数，避免误更新现有文档。

关键思路 #

你之前遇到的问题是因为直接用findOneAndUpdate时，如果没限制更新逻辑，它会覆盖现有文档。但MongoDB的$setOnInsert操作符刚好能解决这个——它只会在执行upsert（插入新文档）的时候生效，找到现有文档时完全不会修改它。

具体代码示例（Node.js MongoDB驱动v4+） #

const { MongoClient } = require('mongodb');

async function findOrCreateOne(client, dbName, collectionName, filter, defaultData) {
  const collection = client.db(dbName).collection(collectionName);
  
  const result = await collection.findOneAndUpdate(
    filter, // 查询条件，比如 { _id: 'target-id' } 或 { name: 'unique-name' }
    { $setOnInsert: defaultData }, // 只有插入新文档时才会设置这些值
    {
      upsert: true, // 没有找到匹配文档就创建
      returnDocument: 'after', // 返回操作后的文档（找到的原文档或新创建的文档）
      // 可选：如果需要指定返回字段，添加 projection: { _id: 1, name: 1 }
    }
  );

  return result.value;
}

// 使用示例
async function main() {
  const client = await MongoClient.connect('mongodb://localhost:27017');
  
  const targetDoc = await findOrCreateOne(
    client,
    'your-db',
    'your-collection',
    { email: 'user@example.com' }, // 唯一查询条件
    { name: 'Default Name', age: 30, createdAt: new Date() } // 预设创建数据
  );
  
  console.log(targetDoc);
  await client.close();
}

main().catch(console.error);

为什么这样可行？ #

• $setOnInsert：这个操作符是核心，它的更新逻辑只在MongoDB执行插入（upsert触发）时生效，找到现有文档时会直接跳过更新步骤。
• upsert: true：开启“找不到就创建”的逻辑。
• returnDocument: 'after'：确保返回的是最新的文档——如果是创建的就是新文档，如果是找到的就是原文档（因为没被修改）。

这样就完美实现了原子化的findOrCreate：要么返回已存在的原对象，要么用预设值创建新对象，全程是原子操作，不会有并发问题。

内容的提问来源于stack exchange，提问作者Sebastian Di Luzio