$abs($subtract(...)) 报错是因为mongodb不支持函数式嵌套调用，正确写法是将$subtract表达式作为$abs的唯一参数，即{$abs: {$subtract: ["$a", "$b"]}}，且$subtract必须传入长度为2的数组。
为什么 $abs($subtract(...)) 在聚合里总报错
直接写 $abs($subtract) 会触发语法错误，因为 MongoDB 不支持函数嵌套调用。聚合阶段里的表达式必须是合法的 BSON 对象结构，$abs 和 $subtract 都是操作符（operator），不是可调用函数，不能像 JavaScript 那样括号嵌套。
正确做法是把 $subtract 当作 $abs 的输入参数——也就是把整个 $subtract 表达式作为值传给 $abs。
-
$subtract必须传入**长度为 2 的数组**，如["$a", "$b"]或[10, "$field"] -
$abs只接受**单个数值表达式**，不能是字段名字符串，也不能是未包裹的数字 - 顺序写错（比如
$abs: { $subtract: [...] }）会报 “$abs is not a valid operator”
在 $project 阶段计算两个字段的绝对差
这是最常见场景：比如对比用户当前积分和上期积分，算波动值。注意字段名要加 $ 前缀，且必须用数组形式传给 $subtract。
{
$project: {
abs_diff: { $abs: { $subtract: ["$current_score", "$last_score"] } }
}
}
如果字段可能为 null 或缺失，$subtract 会返回 null，$abs(null) 仍是 null，不会报错但结果不可控。需要提前用 $ifNull 处理：
{ $abs: { $subtract: [{ $ifNull: ["$a", 0] }, { $ifNull: ["$b", 0] }] } }- 避免因类型不一致（如 string 和 number 混用）导致
$subtract返回null
在 $match 阶段用绝对差做条件过滤
不能直接在 $match 里写 $abs，因为 $match 只支持查询操作符（如 $gt），不支持表达式操作符。必须先用 $project 或 $addFields 算出绝对差字段，再 $match。
- 错误写法：
{ $match: { $abs: { $subtract: ["$x", "$y"] } } }→ 语法非法 - 正确链路：
$addFields算diff_abs→$match: { diff_abs: { $gt: 100 } } - 若只关心过滤、不保留中间字段，用
$addFields比$project更轻量
性能与兼容性要注意的点
$abs 和 $subtract 自 MongoDB 3.2 起就完全支持，无版本陷阱。但实际性能取决于上游是否能走索引——绝对差本身无法直连索引，所以如果过滤条件依赖它，务必确认前置字段（如 $current_score）有合适索引。
- 不要在
$group的_id里用$abs($subtract)做分组键，除非你明确需要按绝对差值归类，否则易导致本该合并的文档被拆散 - 在分片集群中，含
$abs/$subtract的聚合无法下推到 shard，会强制在 mongos 合并，大数据量时延迟明显 - 如果只是简单两数相减取绝对值，且数据已加载到应用层，有时在代码里算比在聚合里算更省资源
真正容易被忽略的是类型隐式转换：MongoDB 不会自动把字符串 "123" 转成数字参与 $subtract，结果是 null。查不到数据时，先检查字段类型是否一致。
