首页/数据/NoSQL 速查/findOne 取单条文档
MongoDB99 条

findOne 取单条文档

返回满足条件的第一条文档,不存在时返回 null;适合按 _id 或业务键点查与存在性探测。

NoSQL 速查数据更新于 2026-10-12
语法db.collection.findOne(filter, projection)
返回值单个文档对象或 null

示例

示例
db.users.findOne({ email: "a@example.com" })
if (db.users.findOne({ _id: 1 }) === null) { print("not found") }
findOne 等价于 find(...).limit(1) 取首条,但返回文档而不是游标,更适合交互排查。

易错点

  • 不指定 sort 时“第一条”由存储顺序决定,需要确定结果时必须显式排序
  • findOne 默认返回全部字段,大文档场景用投影减少传输

数据来源与参考

  • MongoDB Manual: db.collection.findOne()
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌