MongoDB 5.0.6中updateOne搭配$set、$cond不生效问题

• 非管道模式的更新操作（即更新参数是普通对象、不是数组的写法），只会识别更新文档顶层的原子操作符（比如$set、$inc），操作符对应的值会被作为普通字面量直接写入集合，不会解析值内部的聚合表达式、字段引用。你第一次写的updateOne就是这种模式，所以嵌套在$set.stock_history里的$cond不会被执行计算，整个结构被原样存进了文档。
• 给更新参数加上方括号传入数组，是MongoDB 4.2版本新增的聚合更新管道语法，这种模式下数组内的每一个元素都会被当做聚合管道阶段执行，支持所有聚合表达式、字段引用计算，这也是你用update加方括号能得到预期结果的原因。
• 你给updateOne传入数组参数时报the update operation document must contain atomic operators错误，核心原因是你当前使用的MongoDB服务端版本，或者配套的MongoDB驱动版本低于4.2：4.2之前的版本不支持在updateOne、bulkWrite操作中使用聚合更新管道语法，会把传入的数组当成非法的更新文档抛出错误。

根据你当前的环境可选两种方案：

方案1：升级环境（推荐） #

将MongoDB服务端升级到4.2及以上稳定版本，同时将使用的MongoDB驱动升级到对应兼容版本，即可直接在bulkWrite的updateOne操作中使用聚合管道语法，不需要改写核心逻辑，示例写法如下：

db.getCollection("products").bulkWrite([
  {
    updateOne: {
      filter: {product_id: '2'},
      update: [
        {
          $set: {
            stock: 2.0,
            availability: true,
            // 修正原表达式的逻辑错误：条件成立时存更新前的stock旧值，否则保留原有stock_history
            stock_history: {
              $cond: [
                {$ne: ['$stock', 2.0]},
                '$stock',
                '$stock_history'
              ]
            }
          }
        }
      ]
    }
  }
])

注意：你之前测试的$cond分支存在逻辑错误，条件成立（旧stock不等于目标值2.0）时应该返回$stock也就是更新前的库存值，你之前写的返回值是2，会导致stock_history被写入新的库存值，达不到留存旧值的目的。

方案2：低版本兼容实现 #

如果暂时无法升级MongoDB到4.2及以上版本，无法使用聚合更新管道，可以拆分两步实现需求：

1. 先根据查询条件查出目标文档的当前stock字段值
2. 将查询到的旧stock值作为字面量写入更新参数，再执行updateOne或者bulkWrite操作

并发场景下使用这个方案需要注意数据一致性：可以通过乐观锁机制避免读写间隙的并发修改导致旧值获取错误——更新时除了业务过滤条件，额外在filter中加上stock: [之前查询到的旧stock值]的条件，如果更新返回的匹配条数为0，说明查询到更新之间库存被其他操作修改过，重试「查询-更新」的流程即可。

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