$topN（前 N 条累加器）
最后更新：2026-10-09
$topN（前 N 条累加器）
$topN 是累加器，返回组内按指定排序规则排在最前的 N 个文档（或 N 个表达式值），自 MongoDB 5.2 起可用。排序由 $group 的 sortBy 指定，n 可以是常量或表达式。常用于排行榜、每组取前几条。
| 分类 | 累加器 |
|---|---|
| MongoDB 版本 | 5.2+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $group: { _id: <键>, topN: { $topN: { sortBy: { <字段>: <1 或 -1> }, output: <表达式>, n: <数字> } } } }返回值：组内排序最前的 N 个值或文档数组
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $topN：每班分数最高的前 3 名
db.scores.aggregate([
{ $group: { _id: '$class', top3: { $topN: { sortBy: { score: -1 }, output: '$name', n: 3 } } } }
])运行结果：
{ "_id": "A", "top3": ["Alice", "Bob", "Carol"] }📌 注意事项
- 需要 MongoDB 5.2 及以上版本
- n 支持表达式，可用文档字段动态指定
- sortBy 不保证唯一，并列时结果顺序不保证
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q$topN 的 n 能用变量吗？
A能，n 可以是引用字段的表达式，如 '$limitCount'。
Q$topN 和 $sort 加 $limit 有什么区别？
A$topN 在分组内取前 N；$sort 加 $limit 对整个管道取前 N。
Q并列名次怎么处理？
A排序相同元素的顺序不保证，需要唯一排序键才能稳定。
