Mongoose更新MongoDB对象数组报schema路径错误如何解决

使用Mongoose执行嵌套数组批量更新操作，目标是将匹配senderId = friendId的所有messages数组元素的read字段置为true，使用的更新代码如下：

Messages.update(
    {_id: docId, "messages.senderId": friendId},
    {
        $set: {"messages.$[elem].read": true}
    },
    {
        multi: true,
        arrayFilters: [{"elem.senderId": friendId}]
    },
    (err, result) => {
        if (err) {
            return res.status(500).json({message: "Something error occured" + err})
        } else {
            return res.status(200).json({message: "Successfully", result})
        }
    }
)

执行后抛出报错：

Could not find path "messages.0.senderId" in schema

当前使用的Schema定义如下：

const Schema = new mongoose.Schema({
    conversations: Array,
    messages: Array
})

报错核心是Mongoose默认开启的Schema严格路径校验机制：

• 仅将messages字段定义为通用Array类型，没有声明数组内部元素的字段结构，Mongoose无法识别数组元素下的senderId、read等嵌套路径
• 当使用$[<identifier>]过滤符搭配arrayFilters做嵌套数组更新时，Mongoose会提前校验更新路径是否在Schema中声明，因为找不到messages数组元素下的senderId路径定义，直接抛出路径不存在的错误
• 参考的MongoDB原生更新语法本身没有问题，故障出在Mongoose层的Schema校验逻辑，不属于MongoDB语法错误。

共有两种可落地的解决方式，优先推荐第一种：

• 方案1：补全Schema的数组结构定义（推荐）
  给messages数组明确声明内部元素的字段结构，让Mongoose能识别到嵌套路径，修改Schema定义如下：

  const Schema = new mongoose.Schema({
      conversations: Array,
      // 明确声明messages数组内的元素结构，字段类型按实际业务调整
      messages: [
          {
              senderId: mongoose.Schema.Types.ObjectId,
              read: Boolean,
              // 其余messages元素包含的字段可按需补充声明
          }
      ]
  })
  

  修改后无需调整原有更新语句，重新执行即可正常完成批量更新。

• 方案2：临时关闭更新操作的严格模式（适用于不想修改Schema的临时场景）
  如果不想调整现有Schema定义，可以在更新操作的配置项中添加strict: false，跳过Mongoose的路径校验，直接将操作下发给MongoDB执行，修改后的更新代码如下：

  Messages.update(
      {_id: docId, "messages.senderId": friendId},
      {
          $set: {"messages.$[elem].read": true}
      },
      {
          multi: true,
          arrayFilters: [{"elem.senderId": friendId}],
          strict: false // 新增配置，跳过Schema路径校验
      },
      (err, result) => {
          if (err) {
              return res.status(500).json({message: "Something error occured" + err})
          } else {
              return res.status(200).json({message: "Successfully", result})
          }
      }
  )
  

  注意：该方式会绕过Mongoose的字段类型校验、默认值设置等内置能力，非特殊场景不建议长期使用。

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