如何在MongoDB单次更新中对对象数组执行upsert操作？

现有MongoDB文档如下：

{
    "title": "something",
    "tags": [
        {
            "name": "tag1",
            "value": "something"
        },
        {
            "name": "tag2",
            "value": "anything"
        },
        {
            "name": "tag3",
            "value": "whatever"
        }
    ]
}

需要基于tags.name批量更新数组中的对象，同时upsert以下2个标签：

[
    { 
        "name": "tag2", 
        "value": "updated" 
    },
    { 
        "name": "tag-new", 
        "value": "new tag" 
    }
]

希望一次操作完成合并，得到结果：

{
    "title": "something",
    "tags": [
        {
            "name": "tag1",
            "value": "something"
        },
        {
            "name": "tag2",
            "value": "updated"
        },
        {
            "name": "tag3",
            "value": "whatever"
        },
        {
            "name": "tag-new",
            "value": "new tag"
        }
    ]
}

请问实现该需求的最优方式是什么？

可以通过MongoDB的聚合管道式更新（MongoDB 4.2+支持）一次完成现有标签的更新和新标签的插入，无需拆分多次操作，具体实现如下：

核心思路 #

1. 从原tags数组中过滤掉与待upsert标签name重复的元素
2. 将过滤后的原标签数组与待upsert的标签数组合并，自动完成“更新现有、新增缺失”的效果

代码示例 #

假设查询条件为{ title: "something" }，待upsert的标签列表定义为newTags，执行以下更新操作：

const newTags = [
    { name: "tag2", value: "updated" },
    { name: "tag-new", value: "new tag" }
];

db.collection.updateOne(
    { title: "something" }, // 匹配目标文档的查询条件
    [
        {
            $set: {
                tags: {
                    $concatArrays: [
                        // 过滤原tags中不在待更新列表里的元素
                        {
                            $filter: {
                                input: "$tags",
                                cond: {
                                    $not: {
                                        $in: [ "$$this.name", newTags.map(t => t.name) ]
                                    }
                                }
                            }
                        },
                        // 合并待upsert的标签数组
                        newTags
                    ]
                }
            }
        }
    ]
);

方案优势 #

• 原子性：一次数据库操作完成所有变更，避免多次操作带来的数据一致性问题
• 高效性：无需拆分“更新现有元素”和“插入新元素”两个步骤，逻辑简洁
• 兼容性：覆盖MongoDB 4.2及以上版本，适配大部分生产环境

不推荐的备选方案 #

如果使用arrayFilters，需要先更新匹配的现有元素，再通过$addToSet或$push插入新元素，但这种方式需要两次数据库操作，且$addToSet无法直接处理复杂对象的去重，需要额外逻辑处理，效率和简洁性远不如聚合管道方式。

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