MongoDB Data API REST接口缺失ArrayFilter 如何更新数组指定元素

MongoDB Data API 单文档更新接口实际支持arrayFilters参数，只是官方文档未明确标注该顶层字段，直接按规范传参即可实现数组指定元素更新，和SDK调用效果一致。

方法一：直接传arrayFilters参数（推荐，和驱动用法一致） #

请求体构造规则：

• 根层级传入常规更新必填字段：dataSource（集群名）、database（库名）、collection（集合名）、filter（父文档匹配条件）、update（更新语句，搭配$[<标识符>]位置操作符使用）
• 根层级平级新增arrayFilters字段，值为数组筛选条件列表，写法和MongoDB官方驱动的arrayFilters完全一致

举个实际场景示例：假设集合内文档结构为订单数据，items字段存商品对象数组，需要将指定订单中sku为a1的商品状态改为shipped，请求体示例如下：

{
  "dataSource": "Cluster0",
  "database": "shop",
  "collection": "orders",
  "filter": {"_id": "order_123"},
  "update": {
    "$set": {"items.$[item].status": "shipped"}
  },
  "arrayFilters": [
    {"item.sku": "a1"}
  ]
}

注意事项：

• arrayFilters必须放在请求根层级，不要嵌套在update对象内
• 位置操作符里的标识符（示例中为item）必须和arrayFilters里的条件前缀完全对应
• 多层嵌套数组筛选可按相同规则传多个筛选条件，接口完全兼容驱动语法
• 若调用时提示参数非法，确认使用的是正式版Data API，早期预览版不支持该参数，可换用下方的聚合更新方案

方法二：聚合管道更新（全版本兼容，无需arrayFilters） #

如果遇到版本不支持arrayFilters的情况，可以直接用聚合管道作为update参数，通过$map+$cond遍历数组实现条件更新，所有版本Data API都支持该写法。

同样以上述需求为例，请求体示例：

{
  "dataSource": "Cluster0",
  "database": "shop",
  "collection": "orders",
  "filter": {"_id": "order_123"},
  "update": [
    {
      "$set": {
        "items": {
          "$map": {
            "input": "$items",
            "in": {
              "$cond": [
                {"$eq": ["$$this.sku", "a1"]},
                {"$mergeObjects": ["$$this", {"status": "shipped"}]},
                "$$this"
              ]
            }
          }
        }
      }
    }
  ]
}

该写法逻辑为遍历items数组，对每个元素做条件判断：匹配sku条件的元素合并更新字段，不匹配的元素原样返回，最终替换原数组实现更新。

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