AppSmith中MongoDB聚合管道添加$addFields报错的解决方法

1. 修复聚合管道的语法错误（解决阶段格式问题） #

你遇到的'A pipeline stage specification object must contain exactly one field'错误，是因为聚合管道的每个阶段必须是仅包含一个顶级操作符字段的独立对象。需要把$addFields作为管道数组里的单独元素，同时修正字段赋值逻辑（因为history是数组类型，不能直接赋值子字段）。

修正后的聚合查询代码（仅用于查询时临时给结果添加元素，不修改数据库原始数据）：

{
    "aggregate": "dids",
    "pipeline": [
        {
            "$match": {
                "_id": ObjectId({{sPhone.selectedOptionValue}})
            }
        },
        {
            "$addFields": {
                "history": {
                    "$push": {
                        "contract_id": {{tableOfContracts.selectedRow._id}},
                        "start_date": {{dtpkStart.selectedDate}}
                    }
                }
            }
        }
    ],
    "cursor": {
        "batchSize": 10
    }
}

2. 关键：区分“查询临时处理”和“持久化修改数据库” #

注意：聚合查询（aggregate）仅返回处理后的查询结果，不会修改数据库中的原始文档。如果你的目的是往数据库的history字段真正插入新记录（持久化保存），应该使用updateOne操作而非聚合查询，示例代码如下：

{
    "updateOne": {
        "filter": {
            "_id": ObjectId({{sPhone.selectedOptionValue}})
        },
        "update": {
            "$push": {
                "history": {
                    "contract_id": {{tableOfContracts.selectedRow._id}},
                    "start_date": {{dtpkStart.selectedDate}}
                }
            }
        }
    }
}

原代码的问题说明 #

• 语法格式错误：你添加的$addFields未作为管道数组的独立元素，或存在引号/逗号语法问题，导致MongoDB判定为不符合阶段规范的对象。
• 逻辑错误：直接赋值history.contract_id会将history从数组类型强制转为对象类型，覆盖原有数组数据，而非添加新元素。必须用$push操作符给数组追加新的对象元素。

内容的提问来源于stack exchange，提问作者Raul Martinez Ramirez