$rename是MongoDB中唯一用于批量重命名字段的操作符，需配合updateMany使用，语法为db.collection.updateMany({},{$rename:{"old":"new"}})，支持多字段及嵌套字段（用点号分隔），但不支持数组内字段，且重命名后字段顺序可能变化。
能批量改字段名，但必须用 $rename，不能用 $set 或其他更新操作符 —— 否则只是改值，不是改名。
用 updateMany + $rename 一次性重命名多个字段
这是最常用、最安全的方式，适用于 MongoDB 4.2+（推荐），支持一次重命名多个字段，且原子性保障在单文档级别。
- 语法结构固定：
db.collection.updateMany({<query>}, {$rename: {"oldName": "newName", "oldField": "newField"}})</query> - 查询条件为空对象
{}表示匹配全部文档；也可加条件，比如只重命名status为"active"的文档：{status: "active"} - 字段名必须是字符串字面量，不能是变量（除非拼接字符串后用
eval，但不推荐） - 如果目标新字段名已存在，
$rename会直接覆盖（删除原newName字段，再把旧字段值写入）
重命名嵌套字段时路径写法要带点号
$rename 支持嵌入式文档字段，但路径必须用点号（.）分隔，不能用数组下标或 $ 符号。
- 正确：把
user.profile.name改成user.profile.fullName→{"user.profile.name": "user.profile.fullName"} - 错误：
{"user.profile[0].name": "..."}或{"user.profile.$[].name": "..."}——$rename不支持数组内字段重命名 - 注意：重命名后字段顺序可能变化（MongoDB 5.0+ 按字典序处理字段），别依赖字段位置做解析
Java Driver 中要用 Updates.rename() 而不是手拼 BSON
Java 客户端不能直接传字符串键值对，必须用官方提供的 Updates.rename() 工具方法，否则会报类型错误或静默失败。
- 正确写法：
collection.updateMany(new Document(), Updates.rename("oldKey", "newKey")) - 多字段重命名需链式调用：
Updates.rename("a", "x").rename("b", "y")（注意不是传 Map） - 如果用 Spring Data MongoDB，对应的是
Update.rename("old", "new")，底层仍转为$rename - 避免用
Document.parse("{...}")手动构造$rename—— 容易漏引号、格式错，且类型不安全
别踩这些坑：空查询、不存在字段、大小写敏感
$rename 看似简单，但几个边界情况容易导致“没报错也没生效”：
- 查询条件为空但集合为空 → 命令成功返回，但
matchedCount和modifiedCount都是 0，容易误以为失败 - 想重命名的旧字段在某些文档里根本不存在 → 这些文档被跳过，不报错也不警告
- 字段名大小写敏感：
"Name"和"name"是两个字段，写错一个字母就无效 - MongoDB 5.0+ 允许空
$rename操作（如{$rename: {}}），它不报错但也不做任何事 —— 别在调试时误留空对象
真正麻烦的不是语法，而是确认重命名是否真的落到每一条数据上。建议先用 find({oldField: {$exists: true}}).count() 查存量，再比对 updateMany 返回的 modifiedCount，最后抽样验证文档结构。字段名一旦改错，回滚只能靠备份 —— 没有 $undo 这种东西。
