MongoDB：将文档内嵌对象属性提升为根级字段的实现方案

你原有代码执行不符合预期的核心原因是JavaScript对象字面量的语法规则：在{ '$set': { key: obj.address[key] } }这段逻辑中，key不会被解析为循环中定义的动态变量，而是会被识别为固定的字符串字段名"key"，因此最终只会新增一个名为key的字段，无法生成动态命名的属性。

方案1：修复逐文档循环写法（全MongoDB版本兼容） #

不要直接在update参数里嵌套写动态字段的对象字面量，先单独构造好动态更新对象，再传入更新语句，更新完成后可按需删除原有的嵌套address字段：

db.employees.find().forEach(function(doc) {
  // 跳过不存在address字段的异常文档
  if (!doc.address || typeof doc.address !== 'object') return;

  const updateSet = {};
  // 遍历address下的所有属性，组装到更新对象中
  for (const key in doc.address) {
    if (Object.prototype.hasOwnProperty.call(doc.address, key)) {
      updateSet[key] = doc.address[key];
    }
  }

  db.employees.updateOne(
    { _id: doc._id },
    {
      $set: updateSet,
      $unset: { address: "" } // 不需要保留原address字段就加这行
    }
  );
})

方案2：聚合管道批量更新（MongoDB 4.2+ 推荐，性能最优） #

如果你的MongoDB版本在4.2及以上，完全不需要在客户端逐文档拉取处理，直接使用服务端聚合管道完成全量更新，性能远高于循环写法，且自动适配address下所有不统一的键名：

// 先执行聚合验证打平效果，确认无误再执行更新
db.employees.aggregate([
  {
    $replaceRoot: {
      newRoot: {
        $mergeObjects: ["$$ROOT", "$address"]
      }
    }
  },
  { $unset: "address" }
])

// 验证结果符合预期后，执行批量更新
db.employees.updateMany(
  {},
  [
    {
      $replaceRoot: {
        newRoot: {
          $mergeObjects: ["$$ROOT", "$address"]
        }
      }
    },
    { $unset: "address" }
  ]
)

这个方案全程在MongoDB服务端执行，不需要把文档传输到客户端处理后再写回，数据量较大时优势非常明显。

• 执行任何批量更新操作前，务必备份集合数据，先通过聚合语句预览结果再执行写入。
• 如果根文档层级已经存在和address下同名的字段，合并时address内的字段值会覆盖根层级原有同名字段，如有字段冲突需要提前调整处理逻辑。

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