Mongoose 如何更新嵌套在两层数组内部的对象属性？

报错根因拆解 #

• 字段名拼写错误：集合结构中嵌套子数组字段为RaceResult，但查询、更新逻辑中误写为RaceResults（多了末尾的s），本身无法匹配到对应字段路径。
• 语法兼容性问题：原生MongoDB对多层数组的位置符支持有明确版本限制：
  • 3.6及之前版本仅支持最外层数组用单个$占位符定位，内层数组直接写$.字段名会直接抛出BadValue（错误码2）。
  • 连续两个无命名的$（即Races.$.RaceResult.$.driverName）的写法仅在MongoDB 4.4及以上版本支持，且Mongoose对该写法的兼容性较差，很容易触发路径解析错误。

通用稳定实现方案 #

推荐使用MongoDB 3.6+全版本兼容的命名占位符+arrayFilters写法，灵活适配所有两层嵌套数组的定位更新场景，不存在版本兼容问题。
以本次需求（修改阿布扎比大奖赛下_id为5fd3966d2769dc12dc0105e2的车手姓名为Vettel）为例，正确代码如下：

StandingsModel.updateOne(
  { "Races._id": "5fd3966d2769dc12dc0105df" },
  {
    $set: {
      // 路径中两个占位符分别对应外层Races、内层RaceResult的匹配元素
      "Races.$outer.RaceResult.$inner.driverName": "Vettel"
    }
  },
  {
    // 给占位符绑定匹配规则，自动定位目标元素
    arrayFilters: [
      { "outer._id": "5fd3966d2769dc12dc0105df" },
      { "inner._id": "5fd3966d2769dc12dc0105e2" }
    ]
  }
)

方案优势 #

• 不需要硬编码数组下标，完全靠业务规则匹配定位元素，即使数组顺序变化也不会更新错误位置。
• 灵活适配多条件匹配场景，比如需要批量修改所有阿布扎比大奖赛中第二名的车手姓名，只需要修改对应占位符的匹配规则即可：

arrayFilters: [
  { "outer.gpName": "Abu Dhabi Grand Prix" },
  { "inner.position": "Second" }
]

• 全版本MongoDB兼容，不会触发位置符的解析错误。

补充：MongoDB 4.2+版本甚至可以省略updateOne的第一个查询参数，直接把所有两层的匹配规则都写在arrayFilters里，更新逻辑会自动全量遍历文档定位目标元素，使用更简便。

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