Mongoose如何更新嵌套在文档中的对象数组内的指定属性值？

问题原因整理 #

你之前的代码无法生效的核心原因都是没有正确定位到嵌套数组内的属性，具体问题如下：

• 修改查询返回的文档内存属性后没有调用save()提交，修改仅存在于本地不会同步到数据库；foundList.updateOne用法错误，且直接指定checked为顶层字段，无法匹配到数组内的属性。
• findByIdAndUpdate写法将checked作为文档顶层字段更新，而你的文档顶层不存在该字段，自然不会生效。
• 使用$占位符更新时报错，是因为$需要查询条件中明确匹配数组内的目标元素，才能确定要修改的数组下标，你只指定了清单名称，没有指定数组元素匹配规则，所以报错。

正确实现方案 #

方案1：更新指定清单下的单个任务状态

适用于修改单个特定任务的勾选状态，优先用任务_id匹配避免重名问题：

const listName = 'school';
// 二选一作为任务匹配条件，优先用_id
const targetTaskName = 'do homework'; 
// const targetTaskId = 待修改任务的mongoose_id;

List.findOneAndUpdate(
  { 
    name: listName,
    'items.name': targetTaskName 
    // 用_id匹配则替换为 'items._id': targetTaskId
  },
  {
    $set: {
      'items.$.checked': 1
    }
  },
  { new: true }, // 配置项：返回更新后的文档
  (err, updatedDoc) => {
    if (err) return console.log('更新失败：', err);
    console.log('更新成功：', updatedDoc);
  }
)

方案2：批量更新指定清单下所有任务的勾选状态

适用于要将某清单所有任务统一设置为已勾选的场景：

const listName = 'school';
List.findOne({name: listName}, (err, foundList) => {
  if (err) return console.log('查询失败：', err);
  // 遍历修改所有任务的checked属性
  foundList.items.forEach(item => item.checked = 1);
  // 提交修改到数据库，不可省略
  foundList.save((err, savedDoc) => {
    if (err) return console.log('保存失败：', err);
    console.log('批量更新成功：', savedDoc);
  })
})

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