$cond是MongoDB聚合管道中实现条件分支的表达式操作符,功能等价于JavaScript三元运算符condition ? trueVal : falseVal,但必须严格采用{ $cond: { if: ..., then: ..., else: ... } }对象语法,不支持数组简写形式。

什么是 $cond,它和 JavaScript 三元运算符有什么关系?
$cond 是 MongoDB 聚合管道中唯一支持“条件分支”的表达式操作符,功能上最接近 JavaScript 的 condition ? trueVal : falseVal。但它不是语法糖,而是必须写成对象形式,且只接受三个键:if、then、else。直接写 { $cond: [cond, trueVal, falseVal] } 会报错 —— 这是新手最常踩的坑。
它只能用在支持表达式的阶段里,比如 $project、$addFields、$set(4.2+),不能单独出现在 $match 或 $sort 中。
怎么写一个合法的 $cond 表达式?
必须用命名字段形式,结构固定:
{ $cond: { if: { $gt: ["$score", 80] }, then: "A", else: "B" } }
常见错误包括:
- 把布尔表达式直接当
if值(如if: "$score > 80")→ 必须用操作符,比如$gt、$eq、$and - 在
then或else中引用不存在字段(如then: "$grade"但文档没这个字段)→ 会返回null,不是报错 - 嵌套太深导致可读性崩溃 → 建议先用
$let提前计算中间条件,再传给$cond
如何处理多分支(类似 else if)?
MongoDB 没有 $elif,只能靠 $cond 嵌套实现:
{ $cond: {
if: { $gt: ["$score", 90] },
then: "A",
else: { $cond: {
if: { $gt: ["$score", 80] },
then: "B",
else: "C"
}}
}}
注意缩进和括号匹配;超过三层嵌套建议拆到 $addFields 阶段预计算布尔标志位,比如先加 isHigh、isMedium 字段,再用单层 $cond 判断。
另外,$switch 在 3.4+ 可替代复杂嵌套,但它的 branches 数组不支持动态字段名,灵活性不如嵌套 $cond。
使用 $cond 时性能和兼容性要注意什么?
$cond 本身开销极小,但它的 if 表达式如果涉及全表扫描式判断(比如 $regex 或未建索引的字段比较),会拖慢整个聚合。尤其在 $group 后使用时,别忘了 $cond 是对每条输出文档逐行计算的。
兼容性方面:3.2+ 支持完整对象语法;3.0 只支持数组语法 { $cond: [cond, t, f] }(已弃用,不推荐);4.2+ 允许在 $set 中直接用,比 $addFields 更简洁。
真正容易被忽略的是:当 then 或 else 返回数组或嵌套文档时,MongoDB 不会自动展开或类型校验 —— 如果后续阶段假设它是字符串,而实际是 null 或数组,就可能静默失败。











