该用 $reduce 时是需对数组做有状态的逐项累积计算，如求加权和、拼接带分隔符字符串、找最大值并保留关联字段或转数组为嵌套对象；它支持状态传递（$$value 和 $$this），而 $sum 仅求数字和、$map 仅无状态映射，硬套 $reduce 处理简单聚合会冗余低效。
什么时候该用 $reduce 而不是 $sum 或 $map
$reduce 的核心价值在于「对数组做有状态的逐项累积计算」，比如求加权和、拼接带分隔符的字符串、找最大值同时保留关联字段、或把数组转成嵌套对象。它不像 $sum 那样只能处理数字相加，也不像 $map 那样只做无状态映射——$reduce 允许你在每次迭代中读取上一次的累加结果（$$value）和当前元素（$$this），并决定下一步怎么更新。
常见误用场景：仅需求和/计数/取最大最小值时硬套 $reduce，既冗余又影响性能；或者在不需要状态传递时（如统一转换每个元素）却放弃更简洁的 $map。
- 适合用
$reduce：计算加权平均（权重在数组每项里）、按顺序拼接带前缀的字符串、从对象数组中提取某个字段并去重合并为集合 - 不该用
$reduce：纯数字数组求和 → 用$sum；给每个元素加一个固定字段 → 用$map；只取第一个非空值 → 用$arrayElemAt+$filter
$reduce 的三个必需参数怎么填才不报错
必须显式指定 input、initialValue 和 in，缺一不可。最容易出错的是 initialValue 类型和 in 表达式的返回值类型不一致——MongoDB 不做隐式类型转换，一旦某次迭代返回了字符串，下一次再试图对它做数值运算就会直接报错："$reduce requires an initial value of the same type as the result of the in expression"。
-
input：必须是数组表达式，可以是字段名（如"$tags"）、$filter输出，甚至嵌套的$map结果 -
initialValue：类型必须与你期望的最终结果一致。想返回对象？这里就得写{}；想返回数字？写0；想返回字符串？写"" -
in：必须是一个表达式，且每次都要返回和initialValue同类型的值。常用组合：{$add: ["$$value", "$$this.score"]}、{$concat: ["$$value", ", ", "$$this.name"]}、{$mergeObjects: ["$$value", {"$$this.id": "$$this.value"}]}
示例：把 items: [{name: "a", qty: 2}, {name: "b", qty: 3}] 转成 {"a": 2, "b": 3}：
{
$reduce: {
input: "$items",
initialValue: {},
in: { $mergeObjects: ["$$value", { "$$this.name": "$$this.qty" }] }
}
}
嵌套数组或空数组时 $reduce 怎么安全兜底
如果 input 是 null、缺失字段，或空数组 []，$reduce 会直接返回 initialValue——这本身是设计行为，但容易被当成“没生效”。真正危险的是当 input 字段存在但类型错误（比如本该是数组却是字符串），此时会抛出 "$reduce requires an array for input" 错误。
- 兜底建议：在
$reduce外层用$ifNull或$cond预处理input，确保它至少是空数组。例如：$ifNull: ["$items", []] - 避免运行时错误：用
$isArray做类型校验，再配合$cond分流。复杂聚合中建议提前用$set统一规范字段类型 - 调试技巧：在 pipeline 中临时插入
{$addFields: {debug_input: "$items"}}，看实际传入的值是不是预期数组
和 JavaScript 的 reduce 相比，$reduce 有哪些关键限制
MongoDB 的 $reduce 没有回调函数、不能提前退出（没有 break 或 return）、不支持多参数累加器（只有 $$value 和 $$this），也不能访问外部变量——所有逻辑必须塞进 in 表达式里。这意味着没法直接实现“找到第一个匹配项就停止”的逻辑，必须遍历整个数组。
- 无法短路：即使你只想找第一个
status: "active"的对象，$reduce仍会扫完整个数组。此时更适合用$arrayElemAt+$filter - 不能解构：JavaScript 中可写
(acc, {id, name}) => {...}，而聚合中必须显式写"$$this.id"和"$$this.name" - 性能注意：深层嵌套的
$reduce（比如in里再套$reduce）会导致执行时间线性增长，大数据量时务必压测
最常被忽略的一点：$$value 在每次迭代中都是上一轮的**完全拷贝**，不是引用。所以别指望靠修改某个字段来“复用”对象——每次都得用 $mergeObjects 或 $setField 显式构造新对象。
