MongoDB更新聚合管道中能否使用upsert参数？

完全可以，MongoDB 4.2及以上版本原生支持在基于更新聚合管道的update操作中启用upsert: true配置。

核心特性说明 #

当upsert触发插入操作时，聚合管道的计算逻辑会基于查询过滤条件中的字段值执行，最终生成要插入的完整文档，查询条件里的字段会默认保留在新插入的文档中。

实际使用示例 #

场景：用户签到统计 #

需求：匹配指定用户的签到记录，存在则签到次数+1、更新最后签到时间；不存在则新建该用户的初始签到记录。
示例代码：

db.userCheckin.updateOne(
  // 查询过滤条件
  { userId: 1001 },
  // 更新聚合管道
  [
    {
      $set: {
        // 记录存在则取原有值+1，不存在则初始化为1
        checkinCount: { $add: [ { $ifNull: [ "$checkinCount", 0 ] }, 1 ] },
        lastCheckinTime: new Date(),
        // 标记更新来源
        updateSource: "daily_checkin"
      }
    }
  ],
  // 启用upsert配置
  { upsert: true }
)

执行结果说明 #

• 若已有userId: 1001的签到记录：仅更新checkinCount、lastCheckinTime、updateSource三个字段，其余原有字段保留。
• 若无匹配记录：自动插入新文档，内容为：

  {
    "_id": ObjectId("xxx"),
    "userId": 1001,
    "checkinCount": 1,
    "lastCheckinTime": ISODate("202x-xx-xxTxx:xx:xx.xxxZ"),
    "updateSource": "daily_checkin"
  }
  

注意事项 #

• 仅常规更新类聚合阶段（$set/$unset/$addFields/$project/$replaceRoot等）支持搭配upsert: true使用，管道中包含$out/$merge阶段时无法使用该配置。
• 若聚合管道的字段定义和查询条件字段冲突，以管道计算出的字段值为准。

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