本文介绍如何通过 MongoDB 的 updateMany 操作配合 $pull 更新器，精准删除满足条件（如 type="CUSTOM" 且 reportId="desiredReport"）的文档中嵌套路径 reportDef.reportParameters 内的特定值（如字符串 "b"）。
本文介绍如何通过 mongodb 的 `updatemany` 操作配合 `$pull` 更新器，精准删除满足条件（如 `type="custom"` 且 `reportid="desiredreport"`）的文档中嵌套路径 `reportdef.reportparameters` 内的特定值（如字符串 `"b"`）。
在 MongoDB 迁移管理（如使用 Liquibase、MongoDB Atlas App Services 或自定义部署脚本）中，“changeset” 并非原生命令，而是指一组可版本化、可复用、幂等的数据变更操作。针对您的需求——批量清理特定类型文档中嵌套数组内的某个元素——最简洁、高效且推荐的 changeset 表达形式即为一条 updateMany 命令。
✅ 核心操作：使用 $pull 移除匹配项
$pull 是 MongoDB 提供的数组更新操作符，可安全地从数组中移除所有等于指定值的元素（支持精确匹配，无需正则或复杂逻辑）。对于嵌套字段，只需用点号（.）语法指定完整路径：
db.collection.updateMany(
{
"type": "CUSTOM",
"reportId": "desiredReport"
},
{
"$pull": {
"reportDef.reportParameters": "b"
}
}
)
? 说明：
- 第一个参数（filter）确保仅影响 type 为 "CUSTOM" 且 reportId 为 "desiredReport" 的文档；
- 第二个参数（update）使用 $pull 沿路径 reportDef.reportParameters 删除所有值为 "b" 的数组项；
- 此操作天然幂等：若某文档中已无 "b"，执行多次也不会报错或产生副作用，符合 changeset 的最佳实践。
⚠️ 注意事项：
- 确保 reportDef.reportParameters 字段存在且为数组类型；若部分文档缺失该路径，$pull 将静默跳过（不会报错），但若需强校验，可添加 $exists: true 和 $type: "array" 到 filter 中；
- 若需删除多个不同值（如 "b" 和 "y"），可改用 $pull 配合 $in：
"$pull": { "reportDef.reportParameters": { "$in": ["b", "y"] } } - 在生产环境执行前，建议先用 find() 验证匹配文档：
db.collection.find({ "type": "CUSTOM", "reportId": "desiredReport" }, { "reportDef.reportParameters": 1 })
? 作为可维护 changeset 的建议结构（例如用于 Liquibase-MongoDB 扩展）：
- changeSet:
id: remove-b-from-report-parameters
author: dev-team
changes:
- updateMany:
collection: collection
filter:
type: "CUSTOM"
reportId: "desiredReport"
update:
$pull:
reportDef.reportParameters: "b"
该操作轻量、可靠、易于审计，是处理此类嵌套数组清理任务的标准方案。
