MongoDB如何向Schema数组字段追加元素保留历史位置记录

当前代码覆盖历史记录的核心原因是更新逻辑写错了：直接在更新参数中传入{ locations, status }会让MongoDB直接将用户文档下的整个locations字段替换为传入的新值，数组原有内容会被直接清空覆盖。
另外还有一个隐性问题：你的Schema中并没有在User根层级定义status字段，status是locations数组子文档的内置属性，原逻辑把status写在根更新字段里，既不符合Schema定义，也不会被Mongoose正常写入。

使用MongoDB的$push数组操作符实现追加写入，不要直接替换整个locations数组，修正后的控制器代码如下：

文件路径：controller/auth.js

exports.addLocation = asyncHandler(async (req, res, next) => {
  // 从请求体取当前上报的单条位置经纬度、对应状态，不需要传全量locations数组
  const {phone, location, status} = req.body;

  const updatedUser = await User.findOneAndUpdate(
    { phone },
    {
      // 用$push往locations数组末尾追加新的位置记录，自动保留所有历史数据
      $push: {
        locations: {
          location,
          status
        }
      }
    },
    // 需要返回更新后的最新文档就把new设为true，需要返回更新前的文档则保留false
    { new: true }
  )

  res.status(200).json({
      success: true,
      msg: "Location record added",
      data: updatedUser
  })
})

• $push是MongoDB原生提供的数组追加操作符，只会往目标数组末尾新增元素，不会修改数组内已有的历史条目
• 你的Schema中locations子项的createdAt字段配置了default: Date.now，追加写入时不需要手动传该字段，Mongoose会自动生成每条位置记录的创建时间
• 如果需要避免重复插入完全相同的位置记录，可以把$push替换为$addToSet，该操作符只会在数组内不存在相同条目时才执行写入
• 如果需要限制历史位置记录的最大存储条数，可以搭配$slice修饰符实现，比如最多保留最近100条记录的写法如下：

$push: {
  locations: {
    $each: [{ location, status }],
    $slice: -100 // 负数表示保留数组最后100个元素
  }
}

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