在 MongoDB 聚合中，$skip 必须置于 $sort 之后才能实现稳定、可预测的分页；若提前使用（如在 $match 或 $lookup 前），会因数据无序导致跳过错误文档，破坏分页一致性。
在 mongodb 聚合中，`$skip` 必须置于 `$sort` 之后才能实现稳定、可预测的分页；若提前使用（如在 `$match` 或 `$lookup` 前），会因数据无序导致跳过错误文档，破坏分页一致性。
MongoDB 聚合管道是有序执行的，各阶段的输出顺序直接影响 $skip 的行为。$skip 本身不关心语义逻辑，它只是简单地“跳过前 N 个输入文档”。因此，其效果完全取决于当前管道上游已产生的文档顺序和数量。
❌ 为什么 $skip 放在开头会失效？
当 $skip 置于 $match 之前（如原始代码所示）：
- 它作用于整个集合的原始顺序（通常为插入顺序或磁盘物理顺序，不可控且无业务意义）；
- 若 offset=1, limit=10，它会跳过第 1 个插入的文档——哪怕该文档根本不符合后续 $match 条件；
- 更严重的是，$lookup 和 $addFields 等阶段可能改变文档结构甚至数量（如一对多关联产生数组），导致 $skip 计算的偏移量完全失准。
同样，若 $skip 置于 $sort 之前（即使已在 $match 之后），结果仍不可靠：
{ $match: { type: "lemon" } },
{ $skip: 1 }, // ⚠️ 此时 lemons 未排序！跳过的可能是任意一个 lemon（取决于存储顺序）
{ $sort: { key: 1 } }由于未排序，$skip 行为依赖于 MongoDB 内部文档遍历顺序（受索引、碎片、版本等影响），分页结果无法复现，翻页时易出现重复或遗漏。
✅ 正确的分页执行顺序（推荐实践）
为保障分页稳定性与性能，应严格遵循以下阶段顺序：
-
$match（尽早过滤）
使用索引字段快速缩小数据集，减少后续阶段处理量。 -
$addFields / $lookup（仅限必要计算）
若 $sort 依赖新字段（如关联后的 userReact），需在此处生成；但避免冗余计算。 -
$sort（必须带确定性排序键）
至少包含一个业务主排序字段 + _id，确保唯一性：{ $sort: { "publishDate": -1, "_id": -1 } }? 原因：多个文档可能具有相同 publishDate，仅按该字段排序无法保证跨查询一致性；添加 _id 可消除歧义。
-
$skip（此时跳过的是已排序、已过滤的逻辑结果集）
{ $skip: offset ? offset : 0 } - $limit（截取目标页数据）
- $project / $addFields 等后处理（如脱敏、裁剪字段）
? 示例：修正后的分页管道
[
{ $match: query || {} }, // 1. 先过滤
{ $lookup: { /* ... */ } },
{ $lookup: { /* ... */ } },
{ $addFields: {
userReact: {
$arrayElemAt: [
{ $map: {
input: { $filter: { input: "$reacts", cond: { $eq: ["$$this.publisher", viewerUserName || ""] } } },
in: "$$this.reactType"
}
}, 0
]
}
}
},
{ $sort: { "publishDate": -1, "_id": -1 } }, // 2. 强制确定性排序
{ $skip: offset ? (offset - 1) * limit : 0 }, // 3. 此时 skip 才有意义
{ $limit: limit }, // 4. 限制返回数量
{ $project: {
labels: 0, comments: 0, __v: 0, reacts: 0, publisher: 0
}
}
]⚠️ 关键注意事项
- 性能敏感：$skip + $limit 在大数据集上仍需扫描跳过的全部文档（即使不返回）。生产环境建议结合 range-based pagination（如用 publishDate
-
索引优化：确保 $sort 字段（及 $match 字段）上有复合索引，例如：
db.collection.createIndex({ "publishDate": -1, "_id": -1 }, { background: true }) - 避免 $skip 在 $lookup 后盲目使用：$lookup 可能扩展文档（如 1:N 关联），导致 $skip 数量与预期不符——务必在 $lookup 后通过 $unwind 或 $group 明确文档粒度后再分页。
✅ 总结
$skip 不是“跳过第 N 条记录”，而是“跳过当前管道流中的前 N 个文档”。它的正确性完全依赖上游阶段是否已产出确定、稳定、符合业务逻辑的有序结果集。因此，永远将 $skip 置于 $sort 之后、$limit 之前，并配合唯一排序键，才是 MongoDB 分页的黄金法则。
