$objectToArray可将内嵌对象动态转为[{k:"key",v:value}]格式数组，支持任意键名（含点号、空格等），但需先用$ifNull兜底非对象输入，配合$filter/$map筛选重构，再用$arrayToObject还原，注意内存膨胀与类型丢失。
用 $objectToArray 把内嵌对象转成键值对数组
MongoDB 3.4+ 提供了 $objectToArray，专门干这事：把任意对象（比如 { "a": 1, "b": 2 }）变成 [{ "k": "a", "v": 1 }, { "k": "b", "v": 2 }]。它不关心字段名是什么、有多少个，纯动态处理。
常见错误是直接对非对象字段用它——会返回 null 或报错 errmsg: "$objectToArray requires object input"。务必先用 $ifNull 或 $cond 做类型兜底。
示例场景：日志文档里有个 metadata 字段，结构不固定，想展开分析：
{
"_id": 1,
"event": "login",
"metadata": { "os": "iOS", "version": "15.2", "device_id": "abc123" }
}
聚合阶段写法：
{ $addFields: { "metadata_kv": { $objectToArray: "$metadata" } } }
结果中 metadata_kv 就是数组，每个元素带 k（键）和 v（值）。
字段名含点号或空格时 $objectToArray 仍可用
有人担心字段名像 "user.email" 或 "session id" 会影响转换——不会。$objectToArray 操作的是对象的运行时结构，不是字符串解析，所以点号、空格、中文、emoji 都能照常转成 k 字段的值。
但后续如果要用 $filter 或 $map 处理这些键，就得注意：匹配时必须用完整字符串，比如 { $eq: ["$$this.k", "user.email"] }，不能写成 "user.email" 当作字段路径。
容易踩的坑：
- 误以为
$objectToArray支持通配符或正则匹配键名（它不支持，得靠后续阶段过滤） - 在
$group里直接对$objectToArray结果做$push，却忘了它输出的是数组，导致嵌套数组 - 没处理
null或缺失字段，导致整个管道中断（加$ifNull: ["$metadata", {}]更稳妥）
配合 $map 和 $filter 做键值筛选与重构
转成数组只是第一步，真正常用的是从中挑出某些键、改写值、合并结构。这时候 $map 和 $filter 是主力。
比如只保留 metadata 中以 "user." 开头的键，并把前缀去掉：
{ $map: {
input: { $filter: {
input: { $objectToArray: { $ifNull: ["$metadata", {}] } },
cond: { $regexMatch: { input: "$$this.k", regex: "^user\." } }
}
},
as: "kv",
in: { k: { $replaceAll: { input: "$$kv.k", find: "user.", replacement: "" } }, v: "$$kv.v" }
}
}
关键点：
-
$filter必须用$$this引用当前数组元素，不是$this -
$replaceAll在 4.4+ 才有，低版本得用$substrCP+$strLenCP组合截取 - 如果要还原成对象（比如只取几个键再变回对象），得接
$arrayToObject，但它要求输入数组每个元素必须含k和v字段
性能和兼容性要注意的硬限制
$objectToArray 本身开销不大，但它的输出会显著增加内存占用——原来一个对象可能占几百字节，转成数组后每个键值对都带字段名（k/v）、额外 JSON 结构，膨胀 2–3 倍很常见。大数据量聚合时容易触发 errmsg: "Exceeded memory limit..."。
规避办法：
- 尽早用
$filter缩减数组长度，别等最后才筛 - 避免在
$facet多个分支里重复调用它 - 4.2 及以下版本不支持直接在
$group的$push里嵌套$objectToArray，需拆成两个阶段 - Driver 层（比如 PyMongo）拿到结果后，
k/v是标准字段名，别误当成原始键名去取值
最易被忽略的是：这个转换不可逆——你丢了原始字段的 BSON 类型信息（比如 NumberLong 变成普通数字），如果下游依赖精确类型，得在转之前用 $type 单独存一份元数据。
