使用MongoDB 4.2驱动调用insert方法时如何在返回结果中获取已插入文档

首先明确：4.x系列MongoDB驱动调整插入API返回值后，确实可以不额外执行findOne查询拿到完整插入文档，根据你的业务场景可以选择两种方案：

方案1：客户端预生成_id（通用高性能方案，无服务端自动生成字段时优先选择） #

MongoDB的_id字段本身支持客户端生成，不需要依赖服务端返回：

• 插入前直接调用对应语言驱动的ObjectId生成方法，把生成的_id赋值给待插入的文档对象
• 执行insertOne/insertMany操作即可，此时你手里的待插入文档本身就是包含_id的完整版本，无需任何额外查询

该方案性能和原生插入完全一致，适合没有依赖MongoDB服务端自动生成字段（如服务端触发器写入字段、$setOnInsert动态字段、默认值字段等）的所有场景。

方案2：用findOneAndUpdate替代插入（存在服务端自动生成字段时使用） #

如果你的插入逻辑依赖服务端生成额外字段，就可以用upsert模式的查询更新方法，直接返回插入后的完整文档，不同语言驱动的实现如下：

Node.js 原生驱动 #

示例代码：

const { ObjectId } = require('mongodb')

const fullDoc = await collection.findOneAndUpdate(
  // 传入临时生成的唯一_id作为查询条件，保证触发新增逻辑
  { _id: new ObjectId() },
  {
    $set: {
      // 填入你要插入的所有文档字段
      username: 'zhangsan',
      age: 25
    }
  },
  {
    upsert: true,
    returnDocument: 'after'
  }
)
// fullDoc.value 就是服务端写入完成后的完整文档

Python Pymongo驱动 #

示例代码：

from bson.objectid import ObjectId
from pymongo import ReturnDocument

full_doc = collection.find_one_and_update(
    {"_id": ObjectId()},
    {"$set": {"username": "zhangsan", "age": 25}},
    upsert=True,
    return_document=ReturnDocument.AFTER
)
# full_doc就是完整的写入后文档

Java驱动 #

示例代码：

import org.bson.Document;
import org.bson.types.ObjectId;
import com.mongodb.client.model.Filters;
import com.mongodb.client.model.ReturnDocument;
import com.mongodb.client.model.FindOneAndReplaceOptions;

Document insertDoc = new Document("username", "zhangsan").append("age", 25);
Document fullDoc = collection.findOneAndReplace(
    Filters.eq("_id", new ObjectId()),
    insertDoc,
    new FindOneAndReplaceOptions().upsert(true).returnDocument(ReturnDocument.AFTER)
);

该方案本质是一次原子性的upsert操作，只和数据库交互一次，相比额外调用findOne少了一次网络请求，性能更优。

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