MongoDB 4.2中更新含点(.)的嵌套字段键的问题咨询

问题场景 #

现有文档结构如下：

const person = {
   name: 'Peter',
   address: {
      'NY.postalCode': 12345,
      'CA.postalCode': 23456,
   }
}

尝试用$set更新address内的NY.postalCode键时，MongoDB会将其解析为嵌套对象NY.postalCode，而非更新原有的扁平化键：

await Person.findByIdAndUpdate(id, {
   $set: {
      'address.NY.postalCode': 98765,
   }
}, { new: true });

执行后得到错误结果：

{
   name: 'Peter',
   address: {
      'NY.postalCode': 12345,
      'CA.postalCode': 23456,
      NY: {
         postalCode: 98765,
      }
   }
}

使用转义字符\u002e也无法解决，且当前无法升级到支持$setField的MongoDB 5.x版本。

解决方案（基于MongoDB 4.2） #

因为4.2不支持直接修改含点的键，需要通过聚合管道配合更新操作来实现，核心思路是将address对象转换为键值对数组，修改目标键后再转回对象。

方法1：聚合管道更新（推荐） #

利用$objectToArray、$map、$arrayToObject等4.2支持的聚合操作符，在更新管道中处理address对象：

await Person.findByIdAndUpdate(id, [
  {
    $set: {
      address: {
        $arrayToObject: {
          $map: {
            input: { $objectToArray: "$address" },
            as: "item",
            in: {
              $cond: [
                { $eq: ["$$item.k", "NY.postalCode"] },
                { k: "NY.postalCode", v: 98765 },
                "$$item"
              ]
            }
          }
        }
      }
    }
  }
], { new: true });

逻辑说明：

• $objectToArray: "$address"：将address对象转换为[{k: "NY.postalCode", v: 12345}, ...]格式的数组
• $map：遍历数组，匹配到键为NY.postalCode的项时替换其值，其他项保持不变
• $arrayToObject：将处理后的数组重新转换为对象，赋值回address字段

方法2：查询后手动更新（备选） #

如果聚合管道写法复杂，也可以先查询文档，手动修改属性后保存：

const doc = await Person.findById(id);
doc.address['NY.postalCode'] = 98765;
await doc.save();

这种方式简单直接，但要注意并发更新风险，若有其他操作同时修改该文档，可能会覆盖变更。

对原聚合尝试的说明 #

你之前的聚合操作未成功，是因为$replaceRoot替换了整个文档的根结构，丢失了name等其他字段，且未将修改后的address合并回原文档。正确做法是保留原文档结构，仅修改address字段。

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