本文详解如何在 MongoDB 聚合 $multiply/$divide 表达式中稳健处理 null 和零值，避免因字段缺失导致 percentCompletion 返回 null，并通过 $ifNull 和条件逻辑确保分子分母始终为有效数值。
本文详解如何在 mongodb 聚合 `$multiply`/`$divide` 表达式中稳健处理 `null` 和零值，避免因字段缺失导致 `percentcompletion` 返回 `null`，并通过 `$ifnull` 和条件逻辑确保分子分母始终为有效数值。
在 MongoDB 聚合管道中，当使用 $add、$divide 等算术操作符时，若任一参与字段为 null，整个表达式结果将直接返回 null（而非 0 或默认值），这是导致 percentCompletion 异常为 null 的根本原因。原始写法中虽在 $add 后追加了常量 0，但 $add: [null, null, null, 0] 仍会返回 null —— 因为 MongoDB 的 $add 遇到任何 null 即短路返回 null，不进行类型转换或默认值兜底。
正确的解决路径是：在参与运算前，对每个可能为 null 的字段显式做空值替换。推荐使用 $ifNull 操作符（语义清晰、性能良好），而非 $cond + $eq 组合，既简化逻辑又提升可读性。
以下是修复后的完整聚合 stage 示例：
{
percentCompletion: {
$multiply: [
{
$divide: [
{
$add: [
{ $ifNull: ["$PROCUREMENT", 0] },
{ $ifNull: ["$SERVICEORDER", 0] },
{ $ifNull: ["$MATERIALTRANSFER", 0] }
]
},
{
$cond: [
{ $eq: [{ $ifNull: ["$MATERIAL", 0] }, 0] },
1,
{ $ifNull: ["$MATERIAL", 1] } // 安全兜底：若 MATERIAL 为 null，除数取 1（避免除零）
]
}
]
},
100
]
}
}
✅ 关键改进说明：
- 分子安全化：$ifNull 将 PROCUREMENT、SERVICEORDER、MATERIALTRANSFER 中的 null 统一转为 0，确保 $add 输出确定数值（如 0 + 0 + 0 = 0）；
- 分母健壮化：先用 $ifNull 将 MATERIAL 的 null 转为 0，再通过 $cond 判断是否为 0 —— 若是，则除数设为 1（防止除零错误）；否则使用原值（注意：此处 else 分支也建议用 $ifNull 二次兜底，增强鲁棒性）；
- 避免隐式类型陷阱：$eq: ["$MATERIAL", null] 在部分驱动或旧版本中行为不稳定，统一用 $ifNull 更可靠。
⚠️ 注意事项：
- 不要依赖 $add: [..., 0] 来“修复” null —— 它无效；
- $cond 的三元语法推荐使用数组形式 [condition, then, else]（新版本语法，更简洁）；
- 若业务要求 MATERIAL 为 0 时结果为 0%（而非 0/1×100=0），需调整 $cond 的 then 值为 0 并确保整体逻辑一致；
- 建议在生产环境聚合前，用 $facet 或临时 $project 阶段输出中间字段（如 numerator、denominator），便于调试验证。
通过以上重构，示例文档：
{
"MATERIAL": 4500.0,
"PROCUREMENT": 0,
"SERVICEORDER": null,
"MATERIALTRANSFER": null
}
将正确输出 "percentCompletion": 0（即 (0+0+0)/4500×100 = 0），而不再是 null。这体现了聚合管道中空值防御前置化的设计原则：不在计算后修补，而在输入端净化。
