MongoDB 4.4起支持$accumulator，但必须完整实现init/accumulate/merge/finalize；漏掉merge会在分片或并行聚合时导致结果错误，因各子任务状态无法合并。
直接说结论：MongoDB 4.4 起支持 $accumulator，但它不是“写个函数就能用”的快捷方式，而是一套必须完整实现 init / accumulate / merge / finalize 的状态机逻辑，漏掉 merge 就会在分片或并行聚合时出错。
为什么 $accumulator 必须写 merge 函数
在单节点集合上测试时，$accumulator 看似不写 merge 也能跑通，但这是假象。一旦数据分布在多个分片、或聚合被 MongoDB 自动拆分为并行子任务（比如 $bucketAuto 或大数据量 $group），每个子任务会各自维护一份状态，最终必须靠 merge 合并——否则结果就是各算各的，总和/最值/平均值全错。
-
merge函数接收两个状态对象（例如state1和state2），返回一个合并后的新状态 - 常见错误是把
merge写成return {...state1, ...state2}，这在求和、计数时没问题，但在求中位数、TopN 或带时间窗口的统计里会彻底失效 - 如果确定永远只在单节点、小数据量下运行，且明确禁用分片（
sh.disableSharding()），才可省略merge；但生产环境不建议这么假设
$accumulator 的 initArgs 不能引用字段路径
在 $bucketAuto 阶段里用 $accumulator，initArgs 数组里禁止出现 "$score" 这类字段路径表达式，只能传常量，比如 [0, 100] 或 ["default"]。否则会报错：FieldPath field names may not start with '$'。
- 错误写法：
initArgs: ["$score"]—— 即使$score是文档字段，也不允许 - 正确做法：把需要动态初始化的值，挪到
accumulate函数里处理，用accumulateArgs: ["$score"]传入 - 这个限制只针对
$bucketAuto；在$group或$bucket中，initArgs可以安全使用字段路径
性能陷阱：JavaScript 执行在服务端，但不等于“快”
$accumulator 的每个函数（init、accumulate、merge、finalize）都在 mongod 进程内执行 JS 引擎（V8），这意味着：
- 每处理一个文档，都要调用一次
accumulate，JS 解析+执行开销远高于原生操作符（如$sum、$max） - 若
accumulate函数里做了JSON.parse、正则匹配或循环遍历数组，延迟会指数级上升 - MongoDB 8.0 已标记
$accumulator为弃用，未来版本可能移除；现在写新逻辑，优先考虑是否能用$reduce+$map+$cond组合替代
一个可用的 Top3 分数累加器示例
假设要对每个学生取最高 3 门课分数之和（非简单 $sum，需去重+截断）：
{ $accumulator: {
init: function() { return { scores: [] }; },
accumulate: function(state, score) {
state.scores.push(score);
return state;
},
accumulateArgs: ["$score"],
merge: function(state1, state2) {
return { scores: state1.scores.concat(state2.scores) };
},
finalize: function(state) {
return Array.from(new Set(state.scores))
.sort((a, b) => b - a)
.slice(0, 3)
.reduce((sum, s) => sum + s, 0);
},
lang: "js"
}}注意 finalize 里用了 Set 去重和 sort，这在旧版 V8（如 MongoDB 4.4 默认）中是安全的；但避免在 accumulate 中做排序——那会让每次插入都变慢。
真正容易被忽略的点是：merge 返回的状态结构，必须和 init 返回的完全一致，否则 finalize 会因 state.scores 不存在而静默失败或返回 null。
