使用Mongoose findByIdAndUpdate更新对象数组失败求助

现有写法的问题 #

1. $set 无效的原因 #

arrayOfObjects.$ 中的 $ 是数组匹配占位符，它需要你在查询条件中明确匹配数组中的某个元素（比如匹配 arrayOfObjects.propertyY），但你当前的 findByIdAndUpdate 只通过文档 _id 查询，没有指定数组元素的匹配条件，所以 $ 无法定位到目标数组项，导致 $set 不生效。

2. $push 操作异常的原因 #

你写的 $push 语法错误，正确格式应该是 $push: { 数组字段名: 要添加的对象 }，而非把 $push 嵌套在数组字段里。
错误写法：

arrayOfObjects: { $push: { propertyY: req.body.Y, propertyX: req.body.X} }

正确写法：

$push: { arrayOfObjects: { propertyY: req.body.Y, propertyX: req.body.X} }

实现需求的正确方式 #

你的需求是：查找指定文档，若数组中存在 propertyY 等于 req.body.Y 的元素，则替换该元素；若不存在，则添加新元素。用 findByIdAndUpdate 实现这个逻辑，需要借助 MongoDB 4.2+ 支持的聚合管道更新：

const example = await Example.findByIdAndUpdate(
  req.body.propertyX, // 目标文档ID
  [
    {
      $set: {
        arrayOfObjects: {
          $cond: [
            // 判断数组中是否存在匹配元素
            { $in: [req.body.Y, "$arrayOfObjects.propertyY"] },
            // 存在则替换：过滤旧元素后合并新元素
            {
              $concatArrays: [
                { $filter: {
                    input: "$arrayOfObjects",
                    cond: { $ne: ["$$this.propertyY", req.body.Y] }
                }},
                [{ propertyY: req.body.Y, propertyZ: req.body.Z }]
              ]
            },
            // 不存在则直接追加新元素
            { $concatArrays: ["$arrayOfObjects", [{ propertyY: req.body.Y, propertyZ: req.body.Z }]] }
          ]
        }
      }
    }
  ],
  { new: true } // 返回更新后的文档（默认返回更新前）
);

代码说明 #

• $cond：实现条件判断，等效于 if-else
• $in：检查目标值是否存在于数组的指定字段中
• $filter：过滤掉数组中旧的匹配元素
• $concatArrays：合并数组完成替换或追加操作

替代方案（优化原生逻辑） #

如果你觉得聚合管道过于复杂，也可以沿用你原来的 findById + save 方式，注意修正变量名错误（原代码中最后是 await recipe.save()，应为 await example.save()）：

const example = await Example.findById(req.body.propertyX);
const validIndex = example.arrayOfObjects.findIndex((v) => v.propertyY === req.body.Y);
if (validIndex === -1) {
    example.arrayOfObjects.push({ propertyY: req.body.Y, propertyZ: req.body.Z });
} else {
    example.arrayOfObjects[validIndex] = { propertyY: req.body.Y, propertyZ: req.body.Z };
    console.log('update');
}
await example.save();

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