MongoDB向嵌套subtasks数组推送对象失败，请求排查错误

你遇到的问题核心在于MongoDB不支持在嵌套数组的更新操作中连续使用两个$位置操作符，也就是"columns.$.tasks.$.subtasks"这种写法是无效的。第一个$确实能正确匹配到目标column元素，但第二个$没办法自动定位到tasks数组里的指定任务，这就是Postman报错的原因。而你的createTask接口能正常工作，是因为它只涉及一层嵌套数组（columns下的tasks），单个$位置操作符就足够完成匹配。

修正后的创建子任务接口代码 #

exports.createSubtask = (req, res) => {
  if (!req.body) {
    res.status(400).send({ message: "Subtask content can not be empty!" });
    return;
  }

  const board = req.params.board;
  const column = req.params.column;
  const task = req.params.task;

  Board.findOneAndUpdate(
    {
      _id: board,
      "columns._id": column,
    },
    {
      $push: {
        // 使用命名位置操作符$[task]来定位目标任务
        "columns.$.tasks.$[task].subtasks": req.body,
      },
    },
    {
      // 添加arrayFilters来指定匹配的task条件
      arrayFilters: [{ "task._id": mongoose.Types.ObjectId(task) }],
      // 可选：如果需要返回更新后的文档，加上new: true
      // new: true
    }
  )
    .then((data) => {
      if (!data) {
        res.status(404).send({
          message: `Cannot find Board/Column/Task with provided ids. Maybe the target task does not exist!`,
        });
      } else res.send({ message: "Subtask was created successfully." });
    })
    .catch((err) => {
      res.status(500).send({
        message: "Error creating Subtask: " + err.message,
      });
    });
};

关键修改点说明 #

1. 替换连续的$为命名位置操作符：
   用$[task]代替原来的第二个$，这个命名操作符可以通过arrayFilters来精准匹配目标任务。

2. 添加arrayFilters选项：
   在findOneAndUpdate的第三个参数（配置选项）中，通过arrayFilters: [{ "task._id": mongoose.Types.ObjectId(task) }]来指定：只有tasks数组中_id等于传入task参数的元素，才会被执行$push操作。这里要注意把字符串格式的task ID转换为ObjectId类型，否则MongoDB无法匹配到对应的文档。

3. 版本要求：
   确保你的MongoDB版本在3.6及以上，因为arrayFilters是从这个版本开始支持的。

额外提示 #

如果需要在响应中返回更新后的完整文档，可以在配置选项里加上new: true，这样then回调里的data就是更新后的文档，方便你验证子任务是否成功添加。

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