如何在MongoDB中通过单次查询完成同一数组字段的增删操作？

问题原因 #

MongoDB不允许在同一个updateOne的顶层更新操作中，同时使用$pull和$addToSet修改同一个数组字段，这会触发字段更新冲突错误。

解决方案：使用聚合管道进行更新 #

MongoDB 4.2及以上版本支持使用聚合管道作为更新操作的参数，通过管道内的多步处理，可以在单次操作中完成数组的删除与添加，且不会产生冲突。

实现逻辑

1. 先用$filter移除目标数组中符合删除条件的元素
2. 再用$concatArrays（或$setUnion，需去重时用）将过滤后的数组与新元素数组合并

代码示例

await Contact.updateOne(
  { _id: secondContact._id },
  [
    // 第一步：过滤掉要删除的条目
    {
      $set: {
        linkedContacts: {
          $filter: {
            input: "$linkedContacts",
            cond: { $ne: ["$$this.contactId", firstContactId] }
          }
        }
      }
    },
    // 第二步：添加新条目
    {
      $set: {
        linkedContacts: {
          $concatArrays: ["$linkedContacts", linkedContacts]
        }
      }
    }
  ]
)

去重版本（替代$addToSet的效果）

如果需要避免添加重复的contactId，可以用$setUnion来合并数组，它会自动去重：

await Contact.updateOne(
  { _id: secondContact._id },
  [
    {
      $set: {
        linkedContacts: {
          $filter: {
            input: "$linkedContacts",
            cond: { $ne: ["$$this.contactId", firstContactId] }
          }
        }
      }
    },
    {
      $set: {
        linkedContacts: {
          $setUnion: ["$linkedContacts", linkedContacts]
        }
      }
    }
  ]
)

说明 #

聚合管道更新的优势在于可以对字段进行连续的逻辑处理，完全避免了同字段多操作的冲突问题，完美实现单次查询完成删除+添加的需求。

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