MongoDB upsert数组内对象字段时生成对象而非数组的解决方法

当使用myarray.0.myfield这类带数组索引的点路径做$set更新时，MongoDB默认按嵌套对象逻辑解析路径：只有识别到路径对应的父字段是数组类型，才会把路径中的数字段判定为数组索引执行写入。如果触发upsert新建文档时myarray字段不存在，MongoDB没有依据识别该字段的数组类型，就会把整条路径拆成嵌套对象，最终生成{ "myarray": { "0": { "myfield": "myvalue" } } }的非预期结构。

方案1：用$setOnInsert显式初始化数组类型（改动最小、兼容性最好） #

这个方案几乎不影响原有已经跑通的已存在文档更新逻辑，只需要在原有更新语句上做极小调整：

• 原有针对已存在文档的$set: { "myarray.0.myfield": "myvalue" }逻辑完全保留
• 新增$setOnInsert操作，仅在upsert新建文档时生效，把myarray初始化为空数组，给MongoDB提供明确的字段类型依据
  示例代码：

db.collection.updateOne(
  { 自定义匹配条件 },
  {
    $set: { "myarray.0.myfield": "myvalue" },
    $setOnInsert: { "myarray": [] }
  },
  { upsert: true }
)

实际执行逻辑：

1. 目标文档已存在时：$setOnInsert完全不触发，原有$set逻辑正常更新数组索引位置的字段，和原有行为完全一致
2. 目标文档不存在触发upsert时：先执行$setOnInsert把myarray初始化为数组，后续$set更新对应索引时，MongoDB会识别到数组类型，正确写入数组结构，不会生成嵌套对象

方案2：用聚合管道式upsert构造固定结构（强数据一致性保障） #

MongoDB 4.2及以上版本支持用聚合管道写法做update/upsert操作，这种方式可以完全跳过隐式类型识别的逻辑，直接构造符合预期的数组结构，从根源上避免类型错配的问题。
示例代码：

db.collection.updateOne(
  { 自定义匹配条件 },
  [
    {
      $set: {
        "myarray": {
          $switch: {
            branches: [
              // 场景1：myarray不是数组类型，直接生成带目标元素的数组
              {
                case: { $not: { $isArray: "$myarray" } },
                then: [ { myfield: "myvalue" } ]
              },
              // 场景2：myarray是长度大于0的数组，直接更新索引0位置的字段
              {
                case: { $gte: [ { $size: "$myarray" }, 1 ] },
                then: {
                  $concatArrays: [
                    [ { myfield: "myvalue" } ],
                    { $slice: [ "$myarray", 1, { $size: "$myarray" } ] }
                  ]
                }
              }
            ],
            // 场景3：myarray是空数组，直接补全首元素
            default: [ { myfield: "myvalue" } ]
          }
        }
      }
    }
  ],
  { upsert: true }
)

• 不要在同一个$set操作块里同时写myarray: []和myarray.0.myfield这两个同路径的字段，MongoDB内部对同前缀的多字段更新没有固定执行优先级，很容易出现初始化结果被点路径更新覆盖的问题，反而引发新的结构异常
• 如果用方案1做初始化，要确认MongoDB版本不低于2.4（该版本开始支持$setOnInsert操作），主流线上版本均已满足该要求

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