如何使用$rename修改MongoDB内嵌数组中的字段名？

这个报错很常见，原因是**$rename操作符没办法直接定位数组内部的字段**——你这里的list_name是数组类型，而非嵌套文档，所以'list_name.name_1'这种路径写法MongoDB无法识别，它不知道要遍历数组里的每一个元素去重命名字段。

要解决这个问题，我们可以利用MongoDB 4.2+支持的聚合管道式更新，通过$map遍历数组元素完成字段重命名，具体操作如下：

正确的更新语句 #

db.getCollection('test').updateMany(
  {}, // 匹配所有文档，和你原来的条件一致
  [
    // 第一步：遍历数组，为每个元素添加name_2字段，值来自原name_1
    {
      $set: {
        list_name: {
          $map: {
            input: "$list_name",
            as: "item",
            in: {
              $mergeObjects: [
                "$$item", // 保留原元素的所有其他字段
                { name_2: "$$item.name_1" } // 添加新字段name_2
              ]
            }
          }
        }
      }
    },
    // 第二步：移除数组元素中的旧字段name_1
    {
      $unset: "list_name.name_1"
    }
  ]
)

代码逻辑说明 #

1. $map遍历数组：逐个处理list_name里的每个元素，用$mergeObjects把原元素的所有字段和新的name_2字段合并，既保留原元素的其他数据，又添加了需要的新字段。
2. $unset移除旧字段：遍历完成后，统一移除数组中所有元素的name_1字段，完成重命名的最后一步。

注意事项 #

• 这个方法要求MongoDB版本在4.2及以上，如果是更低版本，建议先升级，或者用循环遍历每个文档手动修改（后者效率较低，不推荐）。
• 如果数组中存在没有name_1字段的元素，这段代码也能正常处理——$mergeObjects不会添加不存在的name_2，$unset也不会报错。

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