如何使用Mongoose更新MongoDB数组中的嵌套对象字段？

我正在开发LinkedIn克隆项目，需要在User schema的对象数组中存储用户的工作经历、项目、课程等信息。现在用findOneAndUpdate()方法，以user_id为筛选条件尝试添加或更新数组元素，但未达到预期效果。

关键代码与问题表现 #

我的User schema中skills字段的定义：

const userSchema = new mongoose.Schema({
  // ... 其他字段
  skills: [{
    skill: {
      name: {
        type: String,
      },
      level: {
        type: String,
      },
    },
  }],
  // ... 其他数组字段（projects、experience等）
});

当前使用的更新控制器代码：

const updateUser = async (req: Request, res: Response) => {
  try {
    const filter = { user_id: req.body.user_id };
    const update = req.body;
    const updatedUser = await User.findOneAndUpdate(filter, update, {
      new: true,
      upsert: true,
    });
    res.status(201).json({
      status: 'success',
      data: {
        user: updatedUser,
      },
    });
  } catch (err) {
    res.status(400).json({
      status: `ERROR: ${err}`,
      message: 'error updating user',
    });
  }
};

发送的PATCH请求体（尝试添加技能）：

{
    "user_id": "xxxxxxxxxxxxxxxx",
    "title": "Mr.",
    "skills" : {
        "name": "Flute",
        "level": "Novice"
    }
}

得到的响应中，skills数组仅生成了_id，未填入name和level：

{
    "status": "success",
    "data": {
        "user": {
            "_id": "63d3715f2ef9698667230a53",
            "user_id": "xxxxxxxxxxxxxxxx",
            "name": "Jonathan Abitbol",
            "email": "yoniabitbol1@gmail.com",
            "projects": [],
            "skills": [
                {
                    "_id": "63d4068d2df30c9e943e4608"
                }
            ],
            // ... 其他字段
            "title": "Mr."
        }
    }
}

1. 修正Skills Schema的结构问题 #

你的skills数组多嵌套了一层skill对象，但请求体直接传递了name和level，导致Mongoose无法匹配字段，因此只生成了默认的_id。

• 临时适配方案：如果要保留现有schema，请求体需要嵌套skill层：

{
    "user_id": "xxxxxxxxxxxxxxxx",
    "title": "Mr.",
    "skills": {
        "skill": {
            "name": "Flute",
            "level": "Novice"
        }
    }
}

• 更合理的优化方案：简化skills的schema，去掉多余的skill嵌套（符合LinkedIn技能存储逻辑）：

skills: [
  {
    name: { type: String },
    level: { type: String },
    _id: { type: mongoose.Schema.Types.ObjectId, auto: true } // 可选，保持自动生成_id
  }
]

2. 正确添加数组元素（使用$push） #

直接传递数组对象会覆盖整个数组，应该用MongoDB的$push操作符添加单个元素，避免影响已有数据。修改控制器代码：

const updateUser = async (req: Request, res: Response) => {
  try {
    const { user_id, ...updateData } = req.body;
    const filter = { user_id };
    const update = {};
    const options = {
      new: true,
      runValidators: true, // 开启字段验证，确保符合schema规则
      upsert: true
    };

    // 区分普通字段和数组字段处理
    Object.keys(updateData).forEach(key => {
      const arrayFields = ['skills', 'projects', 'experience', 'education', 'languages', 'awards', 'courses'];
      if (arrayFields.includes(key)) {
        // 用$push添加数组元素
        update['$push'] = update['$push'] || {};
        update['$push'][key] = updateData[key];
      } else {
        // 普通字段直接赋值
        update[key] = updateData[key];
      }
    });

    const updatedUser = await User.findOneAndUpdate(filter, update, options);

    res.status(200).json({
      status: 'success',
      data: { user: updatedUser }
    });
  } catch (err) {
    res.status(400).json({
      status: `ERROR: ${err}`,
      message: '更新用户失败'
    });
  }
};

此时添加技能的请求体可直接传递：

{
    "user_id": "xxxxxxxxxxxxxxxx",
    "title": "Mr.",
    "skills": {
        "name": "Flute",
        "level": "Novice"
    }
}

3. 更新数组中的指定元素（使用$set和数组定位符） #

如果要更新数组中已有的元素，需要用$set结合数组定位符（通过_id匹配）：

请求示例（更新指定技能） #

{
    "user_id": "xxxxxxxxxxxxxxxx",
    "skill_id": "63d4068d2df30c9e943e4608",
    "skills": {
        "name": "Flute",
        "level": "Intermediate"
    }
}

控制器中添加更新逻辑 #

// 在之前的forEach循环中修改数组字段的处理逻辑
if (arrayFields.includes(key)) {
  const itemId = req.body[`${key}_id`];
  if (itemId) {
    // 更新指定数组元素
    update['$set'] = update['$set'] || {};
    update['$set'][`${key}.$[elem]`] = updateData[key];
    // 添加arrayFilters匹配指定元素的_id
    options.arrayFilters = [{ "elem._id": itemId }];
  } else {
    // 添加新元素
    update['$push'] = update['$push'] || {};
    update['$push'][key] = updateData[key];
  }
}

4. 注意事项 #

• 开启runValidators: true，确保更新操作符合schema的验证规则（比如必填字段）。
• 避免直接覆盖整个数组，除非明确需要替换所有元素。
• 数组元素的_id是Mongoose自动生成的，更新时需要通过这个_id定位元素。

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