MongoDB中如何限制单次查询返回的数据量？

limit() 是游标方法，必须链式调用在 find() 或 aggregate() 之后；limit(0) 表示无限制，非返回零条；skip() 总是先执行且影响性能；sort() 必须显式指定以保证结果稳定；Node.js 中 limit() 返回 Cursor，需 toArray() 等消费。

limit() 必须链式调用在 find() 之后

直接写 db.collection.limit(10) 会报错，因为 limit() 不是集合方法，而是游标（cursor）方法。只有 find()（或 aggregate()）返回游标后，才能接 limit()。

常见错误是误以为它像 SQL 的 LIMIT 那样可独立使用，结果得到 TypeError: db.collection.limit is not a function。

• db.users.find({status: "active"}).limit(5) ✅ 正确
• db.users.limit(5) ❌ 报错
• db.users.find().limit(-1) ⚠️ 负数会被转为正数，但不推荐——语义不清，易引发误解

limit(0) 等价于不限制，不是“返回 0 条”

limit(0) 是合法调用，但 MongoDB 会将其视为“无限制”，实际行为等同于没写 limit()。这不是 bug，是官方定义的行为（见 MongoDB 4.4+ 文档），但容易让人误以为能“清空结果”。

想确保只返回 0 条？必须配合一个永远不匹配的查询条件，比如 {_id: null} 或 {$expr: false}，而不是依赖 limit(0)。

• db.logs.find().limit(0) → 返回全部文档（游标未被截断）
• db.logs.find({$expr: false}).limit(10) → 确定返回 0 条

和 skip() 搭配时，skip 总是先执行

skip() 和 limit() 的顺序不影响最终结果数量，但影响性能。MongoDB 内部总是先跳过前 N 条，再取 M 条——无论你写成 .skip(20).limit(10) 还是 .limit(10).skip(20)，后者会被自动重排。

这意味着：跳过的文档仍需被扫描、解序列化、过滤（如果带查询条件），只是不返回。页码越大，skip() 越慢，尤其在千万级集合中。

• 第 1000 页（每页 20 条）实际要跳过 19980 条 → 建议改用游标分页（$gt + 索引字段）替代 skip()
• 排序必须显式加 sort()，否则 skip()+limit() 结果不稳定（无索引时游标顺序不保证）

Node.js 驱动里 limit() 返回的是 Cursor，不是数组

在 Node.js 中调用 collection.find().limit(5) 得到的是一个 FindCursor 对象，不是数组。直接 console.log(cursor) 看不到数据，必须用 toArray()、forEach() 或 next() 消费。

忘记 await 或 .then() 就打印出空对象或 Promise，是新手高频问题。

• await collection.find({x: 1}).limit(3).toArray() ✅ 得到数组
• collection.find({x: 1}).limit(3).toArray() ❌ 返回 Promise，不 await 就是 pending 状态
• collection.find({x: 1}).limit(3).next() → 只取第一条，适合单条场景

真正容易被忽略的是：limit() 的生效前提是游标还没被消费。一旦调用了 toArray() 或遍历过一次，再链 limit() 就无效了——它只作用于尚未读取的游标阶段。