云数据库aggregate分页必须用{$skip:n}、{$limit:m}作为pipeline独立阶段，不能链式调用；skip值应为(pageNum-1)*pageSize，且需置于$group、$sort等逻辑阶段之后。
uniCloud 云数据库 aggregate().skip().limit() 分页不生效？
直接在 aggregate() 后链式调用 skip() 和 limit()，但返回数据始终是全部或空——这是因为云数据库聚合流水线中，skip 和 limit 必须作为独立的阶段（stage）写入 pipeline，不能像普通集合查询那样挂载在最后。
常见错误写法：db.collection('orders').aggregate().match({...}).skip(10).limit(10).end() —— 这会报错或静默忽略 skip/limit。
- 正确做法：把
skip和limit显式写成 pipeline 数组中的对象 - 必须确保它们出现在
end()前，且顺序合理（通常skip在limit前） - 注意：聚合流水线中所有阶段都需用
$前缀，如{$skip: 10}、{$limit: 10}
如何在 aggregate 中正确插入分页阶段
假设你要对订单按用户分组统计金额，并分页展示 Top N 用户。pipeline 至少包含 $group → $sort → $skip → $limit 四个阶段。
关键点：分页阶段必须放在聚合逻辑之后、结果收束之前；若先 $limit 再 $group，就不是「对分组结果分页」，而是「对原始数据截断后分组」，结果完全错误。
-
pageNum = 2、pageSize = 5时，应传{$skip: 5}（跳过前 5 条），而非{$skip: 2} - 总条数不能直接从
aggregate().count()获取——聚合结果的总数需额外用$group+$sum: 1或单独跑一次带count()的 pipeline - 推荐结构：先执行一次仅含
$group+$count的轻量聚合，拿到 total，再执行带分页的主聚合
const res = await db.collection('orders')
.aggregate()
.group({
_id: '$userId',
totalAmount: $.sum('$amount')
})
.sort({ totalAmount: -1 })
.skip((pageNum - 1) * pageSize)
.limit(pageSize)
.end()前端传参与后端计算 offset 容易错在哪
前端常把 pageNum 当作偏移量直接传给云函数，比如传 pageNum=2 就写 skip: 2。这是典型错误——skip 要的是已跳过的记录数，不是页码。
- 第 1 页：skip = 0
- 第 2 页：skip =
pageSize（不是 2） - 第 n 页：skip =
(n - 1) * pageSize - 如果后端接收参数名是
page，务必在云函数里做转换，别依赖前端算好 - 特别注意：当
pageSize动态可变（如用户切换每页 10/20/50 条），skip必须同步重算，不能缓存旧值
为什么 aggregate 分页比普通 find 分页更难调通
因为聚合流水线是声明式处理流，每个 stage 输出都是新文档集，而 find().skip().limit() 是对最终结果集做切片。前者分页位置敏感，后者位置无关。
- 在 pipeline 中插入
{$project: {xxx: 1}}后再skip，和在match后立即skip，跳过的“行数”完全不同 - 使用
$lookup关联后，文档结构膨胀，skip针对的是关联后的文档数，不是主表原始数量 - 真要调试，建议先用
db.command.aggregate(...).end()在 HBuilderX 的「云数据库控制台」里粘贴 pipeline 手动执行，确认阶段顺序和输出条数
最常被忽略的一点：聚合分页无法用 get() 的 offset/limit 参数替代——那些只作用于 find 查询，对 aggregate 无效。必须老老实实写 pipeline 阶段。
