findOneAndUpdate()（更新并返回文档）

最后更新：2026-10-09

findOneAndUpdate()（更新并返回文档）

findOneAndUpdate()更新第一条匹配过滤条件的文档，并返回更新前（或更新后）的文档本身，例如`db.users.findOneAndUpdate({ name: 'Alice' }, { $set: { age: 22 } }, { returnDocument: 'after' })`。通过returnDocument选项控制返回旧值（默认）还是新值。它比updateOne()多了读回文档的能力，适合需要立即使用新值的场景。

📝 语法

db.<集合>.findOneAndUpdate(<过滤条件>, <更新操作>, { returnDocument: 'after', upsert: <bool> })

⚙️ 参数

返回值：更新前（或更新后）的文档；无匹配且未开启upsert时返回null。

▶ 示例

请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：

// findOneAndUpdate：改Alice年龄并返回新文档
const doc = db.users.findOneAndUpdate(
  { name: 'Alice' }, { $set: { age: 22 } },
  { returnDocument: 'after' }
)
doc

运行结果：

{
  _id: ObjectId('64c8a1b20000000000000001'),
  name: 'Alice',
  age: 22
}

📌 注意事项

• 默认返回更新前的文档；要拿新值需设returnDocument: 'after'
• 注意旧版驱动的findAndModify选项名是new而不是returnDocument
• updateOne()返回统计数字，需要文档内容时用本方法

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们