MongoDB updateMany使用$switch报错如何实现字段条件更新

现有集合数据如下：

需要按照以下规则设置offerCategoryState字段的值：

• 当type字段值为DEPOSIT或INSURANCE时，offerCategoryState设为ENABLED
• 当type字段值为DIGITAL_CARD时，offerCategoryState设为SOON
• 其余情况offerCategoryState设为BLOCKED

初始编写的updateMany()更新语句如下：

db.OFFER_CATEGORIES.updateMany(
    {},
    { $set: { offerCategoryState: { $switch: {
               branches: [
                   { case: { $eq: [ "$type", 'DEPOSIT' ] }, then: "ENABLED" },
                   { case: { $eq: [ "$type", 'INSURANCE' ] }, then: "ENABLED" },
                   { case: { $eq: [ "$type", 'DIGITAL_CARD' ] }, then: "SOON" },
               ],
               default: "BLOCKED"
    } } } }
);

语句执行失败，返回错误：

Write error: WriteError{code=52, message='The dollar ($) prefixed field '$switch' in 'offerCategoryState.$switch' is not valid for storage.', details={}

待解决两个问题：

1. 如何编写正确的MongoDB更新语句，实现一个字段的赋值逻辑依赖另一个字段值的更新操作？
2. 如果新环境的集合schema中不存在offerCategoryState这个新字段，要如何在更新时自动新增该字段并完成上述赋值逻辑？

报错核心原因 #

MongoDB从4.2版本开始支持在更新操作中使用聚合表达式，但要求必须将更新操作以聚合管道数组的形式传入。之前的写法属于普通更新模式，该模式下$set只接受静态赋值内容，不会解析$switch这类聚合操作符，会直接把$switch识别为要存储的字段名，因此触发$前缀字段不允许存储的报错。

正确可执行语句 #

db.OFFER_CATEGORIES.updateMany(
  {},
  [
    {
      $set: {
        offerCategoryState: {
          $switch: {
            branches: [
              // 合并两个ENABLED的判断分支，逻辑和原需求完全一致
              { case: { $in: ["$type", ["DEPOSIT", "INSURANCE"]] }, then: "ENABLED" },
              { case: { $eq: ["$type", "DIGITAL_CARD"] }, then: "SOON" }
            ],
            default: "BLOCKED"
          }
        }
      }
    }
  ]
);

对应两个问题的说明 #

1. 要实现字段值依赖同文档其他字段的动态赋值，只需要把更新阶段（比如$set）包裹在数组中传入updateMany的第二个参数即可，MongoDB会将数组内容识别为聚合管道，逐文档计算表达式结果后写入。除了$switch，所有聚合操作符都可以在这种管道更新模式下使用。
2. 不需要额外做特殊配置，上述语句执行时会自动新增不存在的offerCategoryState字段。MongoDB是无固定schema的文档数据库，$set操作如果发现目标字段不存在，会直接创建该字段并写入计算后的值；除非你给集合显式配置了严格的schema校验规则且禁止新增该字段，否则常规场景下直接执行语句即可同时完成字段新增和逻辑赋值。

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