如何使用Mongoose通过API删除MongoDB文档内嵌数组中的任务

问题根因分析 #

• TypeError: Cannot read property 'findByIdAndDelete' of undefined报错：Employee模型未正确导入，导致代码调用时变量为undefined。
• 路由错误：你定义的接口路径是/:empId/tasks/:id，调用时缺少了/tasks/层级，路径不匹配导致无法命中接口。
• 提示删除成功但数据未变化：现有逻辑完全错误，findByIdAndDelete是用来删除整个Employee集合的文档，不是删除文档内嵌数组的子任务；即使执行成功也是删除了整个员工记录，完全不符合需求。

修复步骤 #

1. 先补充Employee模型的导入代码，示例如下（路径根据你的项目结构调整）：

const Employee = require('../models/Employee');

2. SoapUI调用时路径填写为 DELETE /api/employees/{员工empId}/tasks/{待删除任务id}，比如你要删empId为1007的员工的id为6184645df6bbd93340c0e390的任务，完整路径就是/api/employees/1007/tasks/6184645df6bbd93340c0e390
3. 替换原有删除接口的代码为如下实现：

/*
 * Delete task
 */
router.delete("/:empId/tasks/:taskId", async (req, res) => {
  try {
    // 先根据empId找到对应员工，同时用$pull删除todo和done数组中匹配id的任务
    const updatedEmployee = await Employee.findOneAndUpdate(
      { empId: req.params.empId },
      { 
        $pull: {
          todo: { _id: req.params.taskId },
          done: { _id: req.params.taskId }
        }
      },
      { new: true } // 返回更新后的员工文档
    );
    if (!updatedEmployee) {
      return res.status(404).send({
        message: "未找到对应员工"
      });
    }
    console.log(`任务id为${req.params.taskId}已成功删除`);
    res.json(updatedEmployee);
  } catch (e) {
    console.log(e);
    res.status(500).send({
      message: "服务器内部错误: " + e.message,
    });
  }
});

代码说明 #

• 用findOneAndUpdate匹配员工的empId字段，而非直接操作文档_id
• 通过MongoDB的$pull操作符，自动从todo和done两个数组中删除_id匹配的任务，不管任务在待办还是已完成列表都能删除
• 新增了员工不存在的404错误处理，避免无意义的成功提示
• 改用async/await语法，避免回调嵌套，逻辑更清晰

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