求助：Mongoose查询父文档并更新子数组指定元素

问题场景 #

现有项目文档结构如下：

[
  {
    "_id": "642e9f78abebcdd68147d6aa",
    "name": "test two",
    "priority": 0,
    "users": [
      {
        "admin": true,
        "role": 3,
        "_id": "642aa3df4add92f56fe8caab"
      },
      {
        "admin": false,
        "role": 1,
        "_id": "642bf3865808d8888a1995b4"
      }
    ],
    "createdAt": "2023-04-06T10:31:20.033Z",
    "updatedAt": "2023-04-06T10:31:27.863Z",
    "__v": 0
  }
]

需求：通过项目ID 642e9f78abebcdd68147d6aa 找到对应文档，更新users数组中_id为642aa3df4add92f56fe8caab的用户对象。

错误尝试分析 #

第一次尝试：覆盖整个数组 #

const projects = await Project.findOneAndUpdate(
  {
    _id: projectId,
    "users._id": user._id,
  },
  {
    $set: {
      users: update,
    },
  }
);

问题：直接$set: { users: update }会替换整个users数组，而非仅更新匹配到的单个用户元素。

第二次尝试：arrayFilters使用错误 #

const projects = await Project.findOneAndUpdate(
  { projectId },
  { $set: { users: update } },
  { arrayFilters: [{ "users._id": user._id }] }
);

触发错误：

MongoServerError: 标识符 'users' 的数组过滤器未在更新中使用 { $setOnInsert: { createdAt: new Date(1680862292699) }, $set: { users: [ { admin: false, role: 3, _id: ObjectId('642fec54b0a5eea143444e16') } ], updatedAt: new Date(1680862292699) } }

错误原因：

1. 查询条件错误：{ projectId }应为{ _id: projectId }，否则无法匹配目标项目文档。
2. 更新语句未引用过滤器标识符：arrayFilters定义了规则，但$set操作未通过标识符定位数组元素，导致MongoDB提示过滤器未被使用。

正确解决方案 #

方案1：使用位置操作符$ #

位置操作符$会匹配查询条件中第一个符合的数组元素，适合单元素匹配场景：

// 更新单个字段
const projects = await Project.findOneAndUpdate(
  {
    _id: projectId,
    "users._id": user._id
  },
  {
    $set: {
      "users.$.admin": update.admin,
      "users.$.role": update.role
    }
  },
  { new: true } // 返回更新后的文档，可选
);

如果需要替换整个用户对象：

const projects = await Project.findOneAndUpdate(
  {
    _id: projectId,
    "users._id": user._id
  },
  {
    $set: {
      "users.$": update // 直接替换匹配到的用户对象
    }
  },
  { new: true }
);

方案2：使用arrayFilters（推荐多元素/复杂场景） #

当需要匹配多个数组元素或需更清晰的标识符时，使用arrayFilters：

const projects = await Project.findOneAndUpdate(
  { _id: projectId }, // 先定位目标项目文档
  {
    $set: {
      "users.$[user]": update // 用过滤器标识符"user"定位元素
    }
  },
  {
    arrayFilters: [{ "user._id": user._id }], // 定义过滤器，标识符为"user"
    new: true
  }
);

注意：arrayFilters中的标识符（如user）必须和更新语句中的$[user]对应，不能直接用数组名users作为标识符。

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