Mongoose中$运算符未按预期工作，$elemMatch匹配后更新对象错误

架构老林

2026-10-1

问题原因及解决方案

这个问题绝大多数情况不是MongoDB内核导致，主要原因集中在Mongoose版本缺陷、Schema定义不规范两类，具体排查和解决方法如下：

1. 最常见诱因：Mongoose旧版本已知Bug

Mongoose 5.12.0之前的版本存在位置运算符$的映射缺陷：当查询条件使用$elemMatch匹配数组元素时，Mongoose会错误的将更新语句中的$固定替换为下标1，刚好符合你遇到的固定更新下标为1的第二个元素的表现。
解决方法：
执行命令查看当前Mongoose版本：

npm list mongoose

如果版本低于5.12.0，升级到最新稳定版即可修复：

npm install mongoose@latest

2. 第二常见诱因：Schema字段定义不规范

如果你的Meal模型Schema中，没有显式定义result数组的子字段结构，或者result字段类型没有声明为数组，Mongoose在做字段类型映射时会打乱$位置运算符的匹配逻辑，导致索引匹配错误。
解决方法：
检查并修正Schema定义，确保result数组的子字段显式声明，示例如下：

const mealSchema = new mongoose.Schema({
  searchWord: String,
  result: [{
    idMeal: String, // 必须显式声明子字段，不能省略
    strMeal: String,
    // 其他result数组元素的子字段
  }]
})

3. 优化查询写法，规避触发Bug

当你只需要匹配数组元素的单个查询条件时，不需要使用$elemMatch，直接使用点语法写顶层查询条件即可，写法更简洁，也不会触发旧版本Mongoose的$映射Bug，修改后的代码如下：

const filter = {
    searchWord: req.body.searchWord,
    'result.idMeal': req.body.mealData.idMeal // 单条件匹配数组元素无需$elemMatch
};

const update = { $set: { 'result.$.strMeal': req.body.mealData.strMeal } };

const returnData = { returnOriginal: false };

Meal.findOneAndUpdate(
    filter,
    update,
    returnData,
    function (err, foundMeal) {
        res.json(foundMeal.result);
    }
);

如果需要验证实际执行的原生MongoDB语句，可以开启Mongoose调试模式，在代码中加入mongoose.set('debug', true)，即可在控制台打印出实际发送给MongoDB的执行语句，确认$是否被错误替换。

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