Mongoose更新嵌套数组属性语法问题及code28报错排查

我有一个名为users的集合，包含名为compass的数组属性，数组由文档对象组成。示例用户文档如下：

{
  "_id": {
    "$oid": "64c4ef6615fc23530f9f2a29"
  },
  "username": "jay",
  "compass": [
    {
      "point": "64ce3416f695e4ddd587e982",
      "disposition": true,
      "_id": {
        "$oid": "64ceaa650b583901b5744d6b"
      }
    },
    {
      "point": "64ce343bf695e4ddd587e983",
      "disposition": true,
      "_id": {
        "$oid": "64cf622faba9c3c1dd607994"
      }
    }
  ]
}

我在MERN栈中用Mongoose编写函数，实现逻辑：在compass数组中匹配point属性，不存在则新增元素，存在则更新其disposition属性。当前函数代码：

export const setPoint = async(req, res) => {
    try {
        const user = await UserModel.findById(req.body.userId);
        const disposition = req.body.disposition;
        const pointId = req.body.pointId;
        var index = undefined; 
        for (var i = 0; i < user._doc.compass.length; i++) {
            if (user._doc.compass[i].point == pointId) {
                index = i;
            }
        }
        if (index !== undefined) {
            await user.updateOne( 
                {"compass.point": pointId }, 
                { $set: {"compass.$.disposition": disposition } }, 
                false, 
                false );    
        } else {
            const newObj = {point: pointId, disposition: disposition }
            await user.updateOne( {$push: { compass: newObj } } );
        }
        res.status(200).json("Point set.");
    } catch (error) {
        res.status(500).json(error);
    }
}

测试发现，新增元素操作正常，但更新已存在的point时返回500错误，服务器响应：

{
  "index": 0,
  "code": 28
}

排查情况：

• 在mongosh中执行updateOne()可成功修改：

db.users.updateOne(
   { "compass.point": "64ce343bf695e4ddd587e983" },
   { $set: { "compass.$.disposition" : false } }
)

• 已确认pointId与目标point值完全匹配：

console.log(pointId); // 64ce343bf695e4ddd587e983
console.log(user._doc.compass[1].point) // 64ce343bf695e4ddd587e983
console.log(user._doc.compass[1].point === pointId); // true

• 直接指定索引可成功更新：

await user.updateOne( { $set: {"compass.1.disposition": disposition } } );

我的问题 #

1. 服务器响应的code:28代表什么？没找到相关文档说明。
2. user.updateOne的语法哪里错了？
3. 用for循环得到的index变量指定compass元素，替代'compass.$.disposition'的语法是什么？
4. 向数组添加新元素时，只指定了point和disposition，为什么MongoDB自动生成_id字段？

1. code:28的含义 #

这个错误码对应MongoDB的InvalidPositionalOperator，意思是位置运算符$的使用不符合规则。通常发生在更新时查询条件未匹配数组元素，或位置运算符的使用场景不正确。你这里已确认匹配到元素，问题出在Mongoose的调用方式上。

2. user.updateOne的语法错误 #

你混淆了Mongoose文档实例的updateOne方法和Model层的updateOne方法：

• Model层的updateOne(query, update, options)是针对整个集合的查询更新，需要传入查询条件；
• 而通过findById获取的user是文档实例，它的updateOne(update, options)不需要传入查询条件（因为已经指向当前文档）。你传入的第一个参数{"compass.point": pointId}会被当成更新操作的一部分，导致位置运算符$找不到匹配上下文，触发code:28错误。

正确写法有两种：

• 方式一：用Model层更新（推荐，减少一次查询）

if (index !== undefined) {
  await UserModel.updateOne(
    { _id: req.body.userId, "compass.point": pointId },
    { $set: { "compass.$.disposition": disposition } }
  );
}

• 方式二：修改文档实例属性后保存（更直观）

if (index !== undefined) {
  user.compass[index].disposition = disposition;
  await user.save();
}

3. 用index变量指定元素的语法 #

可以通过字符串拼接生成路径：

await user.updateOne({ 
  $set: { [`compass.${index}.disposition`]: disposition } 
});

更简洁的方式是直接修改文档实例属性再保存：

user.compass[index].disposition = disposition;
await user.save();

4. 自动生成_id的原因 #

这是Mongoose的默认行为：只要是嵌套在数组中的子文档（即使未显式定义子文档Schema），Mongoose都会自动为其添加_id字段。

如果不需要自动生成_id，可以在定义UserSchema时为compass数组指定_id: false：

const UserSchema = new mongoose.Schema({
  username: String,
  compass: [{
    point: String,
    disposition: Boolean,
    _id: false // 禁用自动生成_id
  }]
});

内容的提问来源于stack exchange，提问作者Jefferson Paul Jones