MongoDB更新数组内嵌套对象时findOneAndUpdate返回null不生效问题

常见原因 #

• 更新值与原值完全一致：你当前$set的objectIdClasses.$.objectIdClass值和数组内已存储的对应值完全相同，MongoDB会自动跳过无意义的更新操作，不会触发实际写入，部分版本的Shell/驱动会在这种场景下返回null。
• 返回参数配置问题：findOneAndUpdate默认返回更新前的文档，若你手动配置了returnNewDocument: true但无实际写入发生，也会返回null。
• 权限不足：当前操作账号仅拥有集合查询权限，没有更新权限，可以查到匹配记录但无法执行写入操作。
• 主从同步延迟：若你配置了读偏好指向从节点、写偏好指向主节点，可能出现从节点已经同步到目标记录、但主节点尚未写入的情况，导致更新时主节点匹配不到记录。

解决步骤 #

1. 首先验证查询条件确实可以匹配到记录，单独执行查询语句确认：

db.classes.find({
  objectIdUser: ObjectId("111fe6813abdeb1505f5111"),
  "objectIdClasses.objectIdClass": ObjectId('111fe6813abdeb1505f5111')
})

确认有结果返回后再进行后续排查。

2. 测试更新逻辑有效性：将$set的目标值替换为和原值不同的ObjectId，同时添加明确的返回配置执行更新：

db.classes.findOneAndUpdate(
  {
    objectIdUser: ObjectId("111fe6813abdeb1505f5111"),
    "objectIdClasses.objectIdClass": ObjectId('111fe6813abdeb1505f5111')
  },
  { 
    $set: 
    {
      "objectIdClasses.$.objectIdClass": ObjectId('替换为不同的测试ObjectId')
    }
  },
  {
    returnNewDocument: true, // 强制返回更新后的文档
    writeConcern: { w: "majority" } // 确保写入生效后再返回结果
  }
);

3. 验证账号权限：执行一条简单的单字段更新，确认是否有写入权限：

db.classes.updateOne(
  { objectIdUser: ObjectId("111fe6813abdeb1505f5111") },
  { $set: { testTempField: "test" } }
)

查看返回结果的modifiedCount是否为1，若为0则说明账号无更新权限，需要调整权限配置。

4. 排查主从同步问题：临时将读偏好设置为只读取主节点，再执行更新操作：

db.getMongo().setReadPref('primary')
// 再次执行你的更新语句

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