$project 删除嵌套字段必须用点号路径（如"profile.phone": 0），仅写外层字段名（如"profile": 0）只会置null而非删除；删多字段推荐$unset；混合保留/删除时不可混用1和0，需分步或统一策略。
用 $project 删除嵌套字段必须用点号路径，不能只写外层字段名
很多人误以为 $project: { "profile": 0 } 能删掉整个 profile 对象，其实它只会把 profile 字段设为 null（MongoDB 会保留该键），真正想删的是其中某个子字段，比如 profile.phone 或 profile.temp_id，就必须显式写全路径。
常见错误现象：执行后文档里 profile 还在，只是值变成 null 或空对象，后续阶段可能因此报错或逻辑异常。
-
$project: { "profile.phone": 0 }—— 正确：删掉phone子字段，profile其他字段（如name、email）照常保留 -
$project: { "profile": { "phone": 0 } }—— 错误：语法不合法，MongoDB 直接报unknown operator: $project - 若要删多个嵌套字段，可传数组：
$unset: ["profile.phone", "profile.temp_id"]（$unset是$project的语义等价写法，更清晰）
混合使用字段保留与删除时，_id: 0 必须单独成行，且不能和 0 写法混用
当你既要删嵌套字段，又要排除 _id，同时还要保留几个顶层字段（比如 name、email），最容易踩的坑是把 _id: 0 和 "profile.phone": 0 放在同一 $project 阶段里——这会触发 MongoDB 的硬性限制：只要用了任意 : 0 形式删字段，就不能再用 : 1 或表达式。
所以正确做法是分两步，或统一用 $unset：
- 推荐写法（用
$unset）：{ $unset: ["_id", "profile.phone", "metadata.internal_flag"] } - 如果坚持用
$project，只能全删或全留：{ $project: { "_id": 0, "name": 1, "email": 1, "profile.name": 1, "profile.email": 1 } }—— 注意：没列出来的profile下其他字段自动丢弃 - 别写
{ _id: 0, "profile.phone": 0, "name": 1 }，这会直接报错
对不存在的嵌套路径调用 : 0 不报错，但也没效果
$project 中删一个根本不存在的嵌套字段（比如 "address.zipcode": 0，但文档里压根没有 address 字段），MongoDB 会静默忽略，不会报错，也不会影响其他字段。表面看“成功”，实则掩盖了数据结构不一致的问题。
如果你的集合中部分文档有 address，部分没有，靠 "address.zipcode": 0 并不能保证输出结构统一。这时更稳妥的方式是配合 $ifNull 或 $cond 做兜底处理，或者前置加 $match 筛出有该路径的文档。
- 安全兜底示例：
"zipcode": { $ifNull: ["$address.zipcode", "$legacy_zip"] }，再删掉原字段 - 想确认字段是否存在？可用
$exists在$match阶段提前过滤：{ $match: { "address.zipcode": { $exists: true } } } - 别依赖
: 0来“修复”脏数据，它只是投影控制，不是数据清洗
深层嵌套字段删除性能无额外开销，但要注意 $filter 和 $project 的分工边界
删 orders.items.product_id 这种四层嵌套字段，和删 name 一样快，MongoDB 不会遍历数组或对象内容——它只做字段路径匹配。但如果你真正想删的是「数组中满足条件的某些元素」，比如只保留 items 里 status === "shipped" 的项，那就不能用 : 0，得用 $filter 配合 $project。
-
"items": { $filter: { input: "$items", cond: { $eq: ["$$this.status", "shipped"] } } }—— 过滤数组内容 -
"items.shipping_date": 0—— 只删所有items元素里的shipping_date字段，不改变数组长度 - 混淆这两者会导致：要么数组被意外清空，要么该删的字段还在，不该删的却被干掉了
$project 的 : 0 写法只解决最表层的键剔除，稍复杂一点的意图就得切换到 $filter、$map 或 $unset。
