$maxN（前 N 最大值累加器）
最后更新：2026-10-09
$maxN（前 N 最大值累加器）
$maxN 是累加器，返回组内指定字段最大的 N 个值（去重后）的数组，自 MongoDB 5.2 起可用。它不需要排序规则，直接按值大小取最大 N 个，结果顺序不保证。用于每组 Top N 值统计。
| 分类 | 累加器 |
|---|---|
| MongoDB 版本 | 5.2+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $group: { _id: <键>, maxN: { $maxN: { input: <表达式>, n: <数字> } } } }返回值：组内最大的 N 个值数组（去重）
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $maxN：每班最高的 3 个分数
db.scores.aggregate([
{ $group: { _id: '$class', topScores: { $maxN: { input: '$score', n: 3 } } } }
])运行结果：
{ "_id": "A", "topScores": [98, 95, 92] }📌 注意事项
- 需要 MongoDB 5.2 及以上版本
- 自动去重，返回不同的最大值集合
- 与 $topN 不同：$maxN 只要值，$topN 可按排序取文档
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q$maxN 会去重吗？
A会，返回的是不同的最大值集合。
Q$maxN 和 $topN 有什么区别？
A$maxN 只按值取最大 N 个（去重）；$topN 按 sortBy 规则取前 N 条，可带整条文档。
Q结果有序吗？
A不保证顺序，需要排序再 $sort。
