MongoDB聚合中如何重命名新增字段？寻求高效替代方案

最优方案：直接替换原user字段，跳过中间字段 #

如果你的最终目标就是把原user字段替换成只包含active和metadata的对象，完全不需要先创建userMetadata中间字段——直接用$set阶段一步到位，这是性能最好的方式，没有多余的字段生成和阶段开销：

{
  $set: {
    user: {
      active: "$user.active",
      metadata: "$user.metadata"
    }
  }
}

$set会直接覆盖原user字段，把它替换成你需要的结构，连后续的$unset都省了，大数据量下效率最高。

必须保留中间字段userMetadata的场景：用$replaceWith单阶段重命名 #

如果因为业务流程要求必须先生成userMetadata（比如其他聚合阶段要用到这个字段），那可以用MongoDB 4.2+支持的$replaceWith操作符，在单个阶段完成重命名和移除中间字段，比你现在用的$addFields+$unset两阶段更高效：

{
  $replaceWith: {
    $mergeObjects: [
      "$$ROOT", // 保留文档中所有其他字段
      { user: "$userMetadata" }, // 新增/覆盖user字段为userMetadata的值
      { userMetadata: "$$REMOVE" } // 移除userMetadata字段
    ]
  }
}

这个阶段会一次性重构整个文档，避免了多阶段处理带来的额外开销，长列表下的性能表现会比两步操作好很多。

补充说明 #

你提到的$replace操作符应该是对聚合操作符的误解——MongoDB聚合管道中没有单独的$replace操作符，之前尝试的方案可能没正确使用$replaceRoot/$replaceWith，配合$mergeObjects就能轻松实现保留其他字段同时重命名目标字段的需求。

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