MongoDB聚合管道$addFields中$cond使用变量报错排查求助

错误原因 #

你出现报错的核心原因是误用了MongoDB的变量引用前缀：$$双美元符号在MongoDB聚合语法中仅用于识别自定义变量或系统内置变量，而非当前文档的普通字段。你要引用的documentPropertiesProcessed是当前文档的嵌套字段，不属于预定义变量范畴，因此MongoDB抛出「未定义变量」的错误。

排查方向 #

1. 符号含义区分
   • $$前缀：仅用于引用自定义变量（如$let定义的临时变量、$lookup输出的关联变量）或MongoDB内置变量（如$$ROOT、$$NOW）
   • $前缀：用于引用当前聚合上下文中的文档字段
   • 无前缀的字符串会被识别为固定常量值
2. 字段路径验证
   可以先执行简化的聚合阶段验证字段路径是否拼写正确，排除大小写、拼写错误：

   {
       "$project": {
           "testField": "$documentPropertiesProcessed.postProcessingOperatorValidationCount",
           "_id": 0
       }
   }
   

   如果该阶段能正常输出对应字段值，即可确认路径无误。
3. 变量定义验证
   如果你确实有使用自定义变量的需求，需要提前在$let、$set等阶段定义对应名称的变量，再使用$$前缀引用。

修复后的代码 #

直接将$$修改为$即可正常引用文档字段：

{
    "$addFields": {
        "documentPropertiesProcessed.processedToday": {
            "$cond": [
                {"$gte": [
                    "$documentPropertiesProcessed.postProcessingOperatorValidationCount",
                    5
                ]},
                "no",
                "yes"
            ]
        }
    }
}

如果想要更高的可读性，也可以使用$cond的对象写法：

{
    "$addFields": {
        "documentPropertiesProcessed.processedToday": {
            "$cond": {
                "if": {"$gte": ["$documentPropertiesProcessed.postProcessingOperatorValidationCount", 5]},
                "then": "no",
                "else": "yes"
            }
        }
    }
}

内容的提问来源于stack exchange，提问作者Rahul