最稳妥做法是用$set+$unset组合更新，旧字段值复制到新字段同时删除旧字段；数组内子文档迁移必须用$map+$mergeobjects；需注意过滤undefined值、写关注设置、collation配置、索引重建及空值处理。
直接用 $set + $unset 组合更新最稳妥
旧字段值复制到新字段，同时删掉旧字段，这是最常见也最安全的做法。MongoDB 的 updateMany 支持在单条命令里完成赋值和删除，避免中间状态残留。
- 必须用
$set显式指定新字段路径，不能靠$rename——后者只改名，不解决“字段嵌套在数组子文档里”这种场景 - 如果旧字段是
undefined（尤其 MongoDB 8.0+），$set不会自动跳过；得先加{ oldField: { $exists: true, $ne: null } }过滤条件，否则可能把null或空值也复制过去 - 执行前务必在测试库上验证：先用
find查看匹配文档数，再用limit(1)+projection看实际字段结构，避免误操作
数组内子文档迁移必须用 $map + $mergeObjects
当旧字段在数组的每个子文档里（比如 items: [{ price: 100, oldDiscount: 5 }] ），不能靠简单 $set，必须用聚合管道更新。
- 语法核心是
$set: { "items": { $map: { input: "$items", in: { $mergeObjects: [ "$$this", { newDiscount: "$$this.oldDiscount" } ] } } } } -
$$this指当前子文档，$mergeObjects是安全合并方式，不会覆盖子文档原有字段 - 如果旧字段可能不存在于某些子文档，加
$cond判断：{ $ifNull: ["$$this.oldDiscount", null] }，避免生成newDiscount: null - 注意：MongoDB 4.2+ 才支持聚合管道更新，低版本需用应用层循环处理
批量迁移时别忽略 writeConcern 和超时设置
千万级文档一次跑 updateMany，默认写关注（w:1）可能丢数据，且没设超时容易卡住。
- 生产环境建议显式设
{ writeConcern: { w: "majority", wtimeout: 30000 } }，确保多数节点确认才返回 - 配合
collation: { locale: "simple" }避免字符串比较因大小写或重音出错（尤其老数据混杂不同编码） - 如果集合有唯一索引，迁移后立即
db.collection.validate()检查是否触发重复键冲突——$set本身不校验，但新字段值可能违反约束
迁移后记得重建索引并验证查询路径
字段名变了，但旧索引还挂在原字段上，新查询走不到索引，性能会断崖下跌。
- 用
db.collection.getIndexes()查旧索引，用createIndex对新字段建等效索引，别漏掉复合索引里的字段顺序 - 特别注意：如果新字段在数组内（如
"items.newDiscount"），索引必须带$后缀：{ "items.newDiscount": 1 }，否则无法命中 - 用
explain("executionStats")对比迁移前后同一条查询的executionTimeMillis和nReturned，确认索引生效
