Mongoose $push向不存在的内嵌数组推送对象失效解决方案

你写的$push逻辑未生效通常是以下两类原因导致：

• Mongoose的updateOne是异步方法，返回Promise对象，未加await/未调用.exec()时，操作不会真正提交到数据库执行
• 存量文档中notifications字段存在但类型非数组（比如早期误写入为null、对象、字符串等脏数据），MongoDB的$push无法对非数组类型字段执行追加操作
• 补充说明：原生MongoDB的$push本身就支持自动创建缺失的数组字段——如果目标数组字段不存在，会先创建空数组再插入元素，不需要手动判断字段是否存在再初始化，只要字段类型符合要求就能正常执行。

如果要100%兼容字段缺失、字段类型错误等存量脏数据场景，使用MongoDB 4.2+支持的聚合管道更新写法，不需要提前查询文档，单条更新语句即可完成所有逻辑：

await User.updateOne(
  { _id: userId },
  [
    {
      $set: {
        // 先规整notifications字段类型：是数组就保留原值，否则重置为空数组
        notifications: {
          $cond: {
            if: { $isArray: "$notifications" },
            then: "$notifications",
            else: []
          }
        }
      }
    },
    {
      $set: {
        // 向规整后的数组追加新通知
        notifications: {
          $concatArrays: ["$notifications", [{ description: "new notifications" }]]
        }
      }
    }
  ]
);

该写法的行为完全符合需求：

• 若notifications字段已存在且是正常数组，直接追加新通知，和$push行为一致
• 若notifications字段不存在，自动初始化为空数组后再追加
• 若notifications字段存在但类型错误，自动重置为空数组后再追加，不会抛出类型错误
• Mongoose会根据Schema定义，自动给新插入的通知补上status: 'unread'、dateAdded为当前时间的默认值，不需要手动传入。

如果你能确认所有存量文档中notifications字段要么不存在、要么是合法数组，没有脏数据问题，只需要给原有代码补上await即可正常运行：

await User.updateOne(
  { _id: userId },
  { $push: { notifications: { description: "new notifications" } } }
);

注意：Mongoose所有异步数据库操作都需要等待Promise执行完成，否则会出现操作不生效、执行顺序不符合预期的问题。

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