在MongoDB的聚合框架里，数据结构往往不是扁平的。当业务把不确定数量的属性塞进一个子文档，例如用户标签、设备指标或配置项，常规查询很难对里面的字段做统一处理。$objectToArray的作用正是把这样一个对象在管道中实时转换成数组，每一对键值变成带有k和v两个字段的元素，从而让后续的$unwind、$group、$sort等阶段可以直接消费。
基础语法与执行原理
$objectToArray是一个在聚合表达式中使用的转换操作符，它接收一个返回对象（document或普通对象）的表达式，输出数组。数组中的每一个元素都是只包含两个固定字段的对象：k代表原对象中的键名，v代表对应的值。这种设计本质上把关联结构线性化，使得原本隐藏在字段名里的信息变成了可遍历的数据。
从执行计划角度看，$objectToArray属于轻量级的投影转换，发生在文档进入下一阶段之前。它不会触发额外的集合扫描，只是对内存中的当前文档做结构重塑。因此即便对象有几十个字段，转换开销也远低于把文档读回应用端再用代码循环。需要注意，如果传入的不是对象而是数组或标量，该操作符会报错，所以实际使用时常用$cond或$type先做类型保护。
下面是一段最简单的管道示例，把每个用户的attributes对象转成数组并展开：
db.users.aggregate([
{
$project: {
name: 1,
attrArray: { $objectToArray: "$attributes" }
}
},
{ $unwind: "$attrArray" }
])
上述代码执行后，原本形如{ color: "red", size: "L" }的attributes，会变成[{ k: "color", v: "red" }, { k: "size", v: "L" }]，再通过$unwind每条记录拆成两行。这种写法在统计哪些标签出现最频繁时非常直接。
结合动态字段做分组统计
很多物联网场景里，设备上报的指标名称不固定，可能今天是temperature，明天是humidity。如果按传统方式写死字段查询，每次加指标都要改代码。利用$objectToArray可以在数据库内把指标对象摊平，再用$group统计每个指标的平均值或数量，应用层完全不用感知字段差异。
具体做法是先转数组、展开，然后按k分组，对v做累加或求平均。由于v可能是数字也可能是字符串，分组前最好用$toDouble或$type做清洗，避免混合类型导致累加失败。下面的例子统计每种指标的上报次数与平均数值：
db.sensors.aggregate([
{ $match: { status: "active" } },
{
$project: {
metricsArr: { $objectToArray: "$metrics" }
}
},
{ $unwind: "$metricsArr" },
{
$group: {
_id: "$metricsArr.k",
count: { $sum: 1 },
avgVal: { $avg: { $toDouble: "$metricsArr.v" } }
}
}
])
这段管道先筛选活跃设备，把metrics对象转数组后展开，最后以指标名为维度聚合。相比把全量文档拉到服务端用Java或Python循环，这种做法减少了网络传输，也降低了应用内存压力。在百万级文档的集合上，配合合适的索引仍能保持秒级响应。
不过也要留意，如果对象嵌套层级很深，$objectToArray只转第一层。遇到{ a: { b: 1 } }这样的情况，转换后v本身还是对象，需要再套一层$objectToArray或者先用$reduce处理。理解这一边界，才能避免在复杂结构上写出错误统计。
与$arrayToObject的逆向配合
有转数组自然有转回对象的需求。$arrayToObject接受包含k和v字段的数组，还原成对象。两者经常成对出现：先用$objectToArray拆开做计算，改完值以后再$arrayToObject拼回去，保持原文档结构不变。例如把用户所有标签值改成大写，再存回原字段。
这种往返操作在清洗数据时很实用。下面的示例先把profile对象拆开，用$toUpper处理v，再组装回去：
db.members.aggregate([
{
$project: {
profileArr: { $objectToArray: "$profile" }
}
},
{
$project: {
profile: {
$arrayToObject: {
$map: {
input: "$profileArr",
as: "item",
in: { k: "$$item.k", v: { $toUpper: "$$item.v" } }
}
}
}
}
}
])
这里$map遍历数组，对每个元素的v调用$toUpper，k保持不变，随后$arrayToObject把数组恢复成对象写入profile字段。整个过程在单条管道内完成，不需要先读出再写回。掌握这种对称用法，可以让MongoDB承担更多数据转换职责，而不是只做存储。
值得注意的是，当对象的键来自用户输入时，转回对象可能出现重复k，此时$arrayToObject会取最后一个，这可能掩盖数据问题。因此在逆向组装前，最好用$group或$addFields确保键唯一，或者在应用层约定对象结构规范，减少脏数据进入数据库。
MongoDB聚合管道$objectToArray修改时间：2026-08-13 11:21:36