Mongoose updateOne更新嵌套数组时目标文档被额外包裹数组问题

我在更新MongoDB嵌套数组中的文档时遇到了一个问题：用Mongo CLI执行updateOne能得到预期结果，更新后的tags数组元素是正常对象；但用Mongoose的TaskModel.updateOne执行类似查询时，目标标签文档被额外包裹在一个数组里。目前我通过调用TaskModel.collection.updateOne（直接使用Mongo驱动）解决了问题，但想确认是不是Mongoose的查询配置出了问题。

Mongo CLI操作代码 #

db.tasks.updateOne({
  task: "goose", 
  tags: {
    $elemMatch:
      { _id: ObjectId("65400b04b5a313bcbe745c3c") }
  }
}, {
  $set: {
    "tags.$": {
      "name": "bar",
      "color": "green",
    }
  }
})

预期结果 #

{ task: "goose", tags: [ {name: "foo", ...}, {name: "bar", color: "green", ...}, ... ] }

Mongoose查询代码 #

TaskModel.updateOne(
  {
    task: "goose",
    tags: {
      $elemMatch:
        { _id: ObjectId("65400b04b5a313bcbe745c3c") }
    }
  },
  {
    $set: {
      "tags.$": {
        name: "bar",
        color: "green",
        "_id": ObjectId("65400b04b5a313bcbe745c3c")
      }
    }
  }
)

实际结果 #

{ task: "goose", tags: [ {name: "foo", ...}, [ {name: "bar", color: green, ...} ], ... ] }

问题原因与解决方案 #

原因分析 #

这种情况大概率是Mongoose的数组自动转换/模式验证逻辑导致的：

• 如果你的Task Schema中tags字段定义为嵌套文档数组（比如[TagSchema]），Mongoose在预处理更新内容时，可能错误地将你传入的单个对象包装成数组，以此维护它认为的数组结构一致性，但在使用$位置操作符时出现了识别偏差。
• Mongoose对更新参数的解析逻辑和原生Mongo驱动不同：原生驱动直接传递更新内容到数据库，而Mongoose会先根据Schema做校验和转换，这个过程中可能误判了你的更新意图。

可选解决方案（除直接调用驱动外） #

• 关闭严格模式：在更新选项中添加{ strict: false }，跳过Mongoose的Schema校验和自动转换：

TaskModel.updateOne(
  { task: "goose", tags: { $elemMatch: { _id: ObjectId("65400b04b5a313bcbe745c3c") } } },
  { $set: { "tags.$": { name: "bar", color: "green", "_id": ObjectId("65400b04b5a313bcbe745c3c") } } },
  { strict: false }
)

• 简化查询条件：无需使用$elemMatch，直接用点语法匹配数组元素的_id，降低Mongoose的识别难度：

TaskModel.updateOne(
  { task: "goose", "tags._id": ObjectId("65400b04b5a313bcbe745c3c") },
  { $set: { "tags.$": { name: "bar", color: "green", "_id": ObjectId("65400b04b5a313bcbe745c3c") } } }
)

• 改用findOneAndUpdate：该方法在处理数组更新时的逻辑更稳定，配合new: true可直接返回更新后的文档：

TaskModel.findOneAndUpdate(
  { task: "goose", "tags._id": ObjectId("65400b04b5a313bcbe745c3c") },
  { $set: { "tags.$": { name: "bar", color: "green", "_id": ObjectId("65400b04b5a313bcbe745c3c") } } },
  { new: true, strict: false }
)

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