MongoDB数组匹配更新或新增失败：$位置运算符报错求助

报错翻译 #

MongoError: 查找并修改操作期间执行计划出错 :: 原因是 :: 位置操作符未在查询中找到所需的匹配项。

问题根源 #

你的代码存在两个核心问题：

1. 查询条件错误使用了位置操作符$，该操作符仅能用于更新语句，不能放在查询条件中匹配数组元素。
2. findOneAndUpdate的upsert参数是针对整个文档的，无法实现“匹配到数组元素就更新，无匹配则新增元素到数组”的逻辑。

解决方案 #

方案1：分两步操作（兼容性强） #

先尝试更新匹配的数组元素，若未找到匹配项（即数组中无目标元素），再执行数组追加操作：

// 第一步：尝试更新匹配的数组元素
let doc = await Images.findOneAndUpdate(
  { 
    "user.id": req.user.id, 
    _id: themeID, 
    imgs: result.Location  // 直接匹配数组中是否存在该元素
  },
  { $set: { "imgs.$": req.body.path } },
  { new: true }
);

// 第二步：未找到匹配则往数组新增元素
if (!doc) {
  doc = await Images.findOneAndUpdate(
    { "user.id": req.user.id, _id: themeID },
    { $push: { imgs: req.body.path } },
    { new: true, upsert: true }  // upsert用于防止整个文档不存在的情况
  );
}

方案2：聚合管道一步实现（MongoDB 4.2+支持） #

利用聚合管道的条件判断逻辑，一次操作完成更新或新增：

doc = await Images.findOneAndUpdate(
  { "user.id": req.user.id, _id: themeID },
  [
    {
      $set: {
        imgs: {
          $cond: [
            { $in: [result.Location, "$imgs"] },  // 判断数组是否存在目标元素
            {
              $map: {  // 存在则遍历替换匹配项
                input: "$imgs",
                as: "img",
                in: { $cond: [{ $eq: ["$$img", result.Location] }, req.body.path, "$$img"] }
              }
            },
            { $concatArrays: ["$imgs", [req.body.path]] }  // 不存在则追加元素
          ]
        }
      }
    }
  ],
  { new: true, upsert: true }
);

关键说明 #

• 方案1适配所有MongoDB版本，兼容性更好；方案2更简洁，但要求MongoDB 4.2及以上版本。
• 若需避免数组元素重复，新增时可将$push替换为$addToSet，但$addToSet仅保证元素唯一性，不会替换已有匹配项。

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