findOne 的定位
findOne 是 MongoDB 集合上按条件取回单条文档的方法，返回一个普通文档对象，没有匹配时返回 null。它不是 find 的简化版：find 返回游标、还要再迭代取数，而 findOne 直接把手里的第一条文档交给你，因此在交互排查、按 _id 点查、判断某条记录是否存在这类场景里更顺手。
基本信息
| 语法 | db.collection.findOne(filter, projection, options) |
|---|---|
| 返回值 | 匹配到的第一条文档对象；无匹配时返回 null |
| 等价写法 | find(filter, projection).limit(1) 再取首条 |
| 可用位置 | mongosh 与各语言驱动均提供同名方法 |
| 游标差异 | 不返回游标，因此没有 close() 之类操作 |
典型使用场景
- 按 _id 或业务唯一键点查，确认某条记录是否存在
- 线上排查时先取一条样例数据，比翻页浏览更快
- 配合投影只取需要的字段，避免把大文档整体拉回客户端
- 脚本里做存在性判断：返回值与 null 比较即可
- 核对字段实际存储类型，判断是字符串还是数值导致的查询不命中
常用写法
常用写法
// 基础点查：按业务键取一条
db.users.findOne({ email: "a@example.com" })
// 只取需要的字段，_id 默认返回，可显式排除
db.users.findOne({ email: "a@example.com" }, { name: 1, _id: 0 })
// 存在性判断：无匹配时返回 null，而不是空对象
if (db.orders.findOne({ _id: 1001 }) === null) { print("not found") }
// 需要确定取到哪一条时必须显式排序
db.tasks.findOne({ status: "queued" }, { _id: 1 }, { sort: { priority: -1 } })易混淆的写法
| 写法 | 实际结果 | 说明 |
|---|---|---|
| findOne({ a: null }) | 匹配 a 为 null 或 a 字段不存在的文档 | 与 SQL 的 IS NULL 语义并不相同 |
| findOne({ a: 1 }) | 只匹配数值 1 | 字段存成字符串 "1" 时不会命中 |
| findOne({}) | 返回集合中的任意一条文档 | 空集合时返回 null |
| findOne({}, { a: 1 }) | 只返回 _id 与 a | 投影写法不能保留与排除混用 |
findOne 等价于 find 加 limit 1 再取首条，但返回文档而不是游标，交互排查时少一层迭代；需要多条结果或要分页时仍应使用 find。