直接改 collection schema 会卡住写入，因 BSON 序列化/反序列化、内存分配、WiredTiger page 分裂和 journal 写放大引发连锁反应，文档变大时 $set/$unset 混用更易触发迁移与锁竞争。
为什么直接改 collection schema 会卡住写入？
MongoDB 本身没有全局 Schema 约束，但高频 update 或 replaceOne 操作中反复增删字段（比如每秒改几十次 user.profile 结构），实际压力不在“校验”，而在 BSON 序列化/反序列化、内存分配、WiredTiger page 分裂和 journal 写放大的连锁反应。尤其当文档变大后，$set 和 $unset 混用容易触发文档迁移，引发锁竞争。
实操建议：
- 避免在业务高峰期执行批量
updateMany({},{ $set: { "meta.version": "2.1" }, $unset: { "legacy_config": "" } })类操作；改用后台任务分批处理，每次不超过 500 条 - 启用
usePowerOf2Sizes（旧版）或确保storage.wiredTiger.engineConfig.configString包含allocation_strategy=best，缓解碎片 - 监控
db.serverStatus().metrics.document中的deleted和reused字段，若reused持续低于 30%，说明迁移频繁
元数据驱动设计：字段定义不写死在代码里，而存在数据库里
核心不是“把 schema 存 MongoDB”，而是把字段行为（是否必填、类型提示、展示顺序、权限标签）抽成独立集合，让应用层按需组装文档结构。这样新增字段只需插入一条元数据，无需触碰已有文档。
实操建议：
- 建一个
schema_fields集合，每条记录类似：{ "_id": "user.phone", "type": "string", "required": true, "ui_order": 3, "read_roles": ["admin", "hr"] } - 读取时用
db.schema_fields.find({ _id: { $regex: "^user\." } })拉取当前有效字段定义，再结合原始user文档做运行时校验与过滤 - 写入前不硬编码
user.address.city，而是查schema_fields判断该路径是否允许写入、是否要转小写——逻辑收口在统一的applySchemaRules()函数里
如何让老字段“软下线”而不删数据？
直接 $unset 会丢失历史，但保留又干扰新逻辑。正确做法是用元数据标记状态，而非物理删除。
实操建议：
- 在
schema_fields中加status: "deprecated"或valid_until: ISODate("2024-12-01")字段 - 应用层读取时自动跳过
status === "deprecated"的字段，但保留原始值；写入时若带该字段，返回ValidationError: field "user.old_tag" is deprecated since 2024-06-01 - 用 TTL 索引清理真正废弃的数据：
db.user.createIndex({ "meta.deprecated_at": 1 }, { expireAfterSeconds: 0 })，再定期updateMany补上时间戳
聚合查询时字段名动态变化怎么处理？
当字段路径由元数据控制（如 profile.field_123 对应“紧急联系人”），$group 或 $facet 就不能写死键名。
实操建议：
- 用
$objectToArray+$filter提取匹配元数据规则的键值对，再$arrayToObject还原；例如：{$addFields: { dynamic_profile: {$arrayToObject: {$filter: { input: {$objectToArray: "$profile"}, cond: {$in: ["$$this.k", ["field_123","field_456"]]}}}}}} - 更稳的方式是应用层生成聚合 pipeline：先查
schema_fields得到当前活跃字段列表，再拼出带具体路径的$project阶段，避免在 agg 中做字符串匹配 - 警惕
$ifNull嵌套过深——字段不存在时返回null比报错好，但聚合结果里一堆null会影响下游统计，建议元数据里明确default_value
真正难的不是存元数据，而是让所有服务（包括遗留 Python 脚本、Node.js API、BI 工具直连）都走同一套字段解析逻辑。漏掉一个地方绕过元数据校验，Schema 就开始漂移。
