find() 返回 findcursor 实例而非 promise，需调用 toarray() 等方法并 await 才执行查询；exec() 不属于原生驱动，findone() 则直接返回 promise。
find() 返回的是 Cursor，不是 Promise
Node.js MongoDB 驱动（v4+）中，collection.find() 方法默认返回一个 FindCursor 实例，而不是 Promise。它本身不执行查询，只构建游标；真正触发数据库请求的是游标上的消费方法（如 toArray()、next()、forEach()）。如果你直接 console.log(collection.find({}))，看到的是游标对象，不是数据，也不会报错——这容易误以为“没查到”或“卡住”。
常见错误现象：
- 写了
const res = collection.find({})，但res是个游标，console.log(res)输出类似FindCursor { ... } - 忘记加
await或链式调用，导致后续代码拿到的是未解析的游标，而非数组或文档
正确做法是显式调用游标方法并 await：
const cursor = collection.find({ name: 'Alice' });
const docs = await cursor.toArray(); // ✅ 触发查询，返回 Promise<document></document>
或一步到位：
const docs = await collection.find({ name: 'Alice' }).toArray();
exec() 在现代驱动中已不存在
exec() 是 Mongoose 的方法，不是原生 MongoDB Node.js 驱动的 API。如果你在用官方 mongodb 包（即 import { MongoClient } from 'mongodb'），调用 collection.find(...).exec() 会抛出 TypeError: cursor.exec is not a function。
容易混淆的点：
- Mongoose 封装了驱动，提供
Model.find().exec()或直接await Model.find()（自动调用exec） - 原生驱动没有
exec，也不需要——它靠toArray()、next()、forEach()等游标方法驱动执行 - 搜索时若混用“mongoose exec mongodb find”，容易导向错误方案
驱动版本影响游标行为和默认返回值
从 v4.0 开始，官方驱动强制使用 Promise + 游标模型；v3.x 虽支持 Promise，但部分方法（如 find().toArray()）仍可传回调。v6.x 进一步移除了所有回调签名，仅保留 Promise 风格。
检查当前驱动版本：
npm list mongodb
若输出类似 └── mongodb@6.7.0，确认你不能写：
collection.find({}).toArray((err, docs) => { ... }) // ❌ 已废弃，报错
而必须写：
try {
const docs = await collection.find({}).toArray();
} catch (err) {
console.error('Query failed:', err.message);
}
另外注意：findOne() 是例外——它直接返回 Promise
const doc = await collection.findOne({ _id: new ObjectId('...') }); // ✅ 正确
不 await toArray() 会导致静默失败或内存泄漏
游标一旦创建但未消费（如没调 toArray()、next() 或 close()），连接池可能持续持有资源，尤其在长周期服务中易引发“Too many open cursors”错误或内存缓慢增长。
典型疏漏场景：
- 在 Express 路由中写了
collection.find({}).toArray()却忘了await，结果返回的是 pending Promise，后续.then()又没处理 rejection - 用
forEach()但内部异步操作（如await fetch()）未用for...await...of，导致循环提前结束 - 调试时只打印游标，没意识到要主动“拉取”数据
安全写法示例（带超时与错误隔离）：
const cursor = collection.find({ status: 'active' });
try {
const docs = await Promise.race([
cursor.toArray(),
new Promise((_, reject) => setTimeout(() => reject(new Error('Query timeout')), 5000))
]);
} finally {
await cursor.close(); // 显式关闭，尤其在异常分支中
}
真正容易被忽略的是：游标不是“一次性的黑盒”，它是可复用、可中断、需手动管理生命周期的对象——这和 findOne() 或 SQL 查询的直觉完全不同。
