$arrayToObject可将含k/v字段的键值对数组转为对象，要求元素严格为{k:"key",v:"val"}格式，支持空数组返回{}，需预处理字段名、路径及非法项。
用 $arrayToObject 将键值对数组转为对象
MongoDB 3.4+ 提供了 $arrayToObject，专门处理形如 [{k: "name", v: "Alice"}, {k: "age", v: 30}] 这类数组。它要求每个元素必须是含 k 和 v 字段的对象——不是任意字段名，也不能缺字段。
常见错误是传入 {key: "...", value: "..."} 或 {field: "...", val: "..."}，这会直接报错："$arrayToObject requires an array of documents with k and v fields"。
- 确保输入数组每个元素都有且仅有
k和v字段（大小写敏感） - 如果原始数据字段名不匹配，先用
$map+$mergeObjects或$replaceRoot重命名 -
$arrayToObject对空数组返回空对象{}，不会报错
从字符串字段动态构造键值对数组
实际中常遇到的是一个字符串字段（如 metadata）存着 JSON 字符串，或一个扁平数组（如 ["name:Alice", "age:30"]），需要先解析再转对象。
例如字段 tags 是 ["env:prod", "region:us-east-1"]，需拆分并转成 {env: "prod", region: "us-east-1"}：
[
{
"$addFields": {
"tagPairs": {
"$map": {
"input": "$tags",
"as": "t",
"in": {
"$let": {
"vars": {
"kv": { "$split": ["$$t", ":"] }
},
"in": {
"k": { "$arrayElemAt": ["$$kv", 0] },
"v": { "$arrayElemAt": ["$$kv", 1] }
}
}
}
}
}
}
},
{ "$addFields": { "tagObj": { "$arrayToObject": "$tagPairs" } } }
]
注意：$split 返回数组，$arrayElemAt 取值时若索引越界会返回 null，所以确保格式统一，否则 $arrayToObject 会静默跳过非法项（不报错但结果缺失）。
处理嵌套在子文档或数组中的键值对数组
当目标数组不在根层级，而在类似 data.attributes 或 items.0.props 这样的路径下，容易忽略路径有效性检查。
- 用
$ifNull包裹路径，避免attributes缺失导致整个 pipeline 报错：{"$arrayToObject": {"$ifNull": ["$data.attributes", []]}} - 若
attributes是多层嵌套（如[{k:"x", v:{y:1}}]），$arrayToObject仍能正常工作，v支持任意 BSON 类型 - 但若数组里混有非对象项（如
null、字符串），$arrayToObject会直接失败，建议前置$filter清洗
性能与兼容性提醒
$arrayToObject 是内存操作，不走索引，纯 CPU 处理。单次处理的数组长度建议控制在几千以内；超过 16MB 文档限制或触发 maxTimeMS 超时，通常是因为输入数组过大或嵌套过深。
旧版本 MongoDB（$reduce 手动累加对象，代码冗长且易出错，不推荐。
最常被忽略的一点：$arrayToObject 不保证键顺序——MongoDB 中 Object 的键序在 3.6+ 后虽按插入顺序保留，但聚合阶段不承诺稳定排序，如有依赖顺序的逻辑（比如取第一个键），得额外用 $objectToArray + $arrayElemAt 控制。
