$concatArray不能直接合并不同结构数组，因其仅接受嵌套数组（如[[1,2],[3,4]]），不自动类型转换或解析对象；传入非数组字段会报错。
为什么 $concatArray 不能直接合并“不同结构”的数组？
$concatArray 只接受一个数组类型的参数，且该参数必须是**多个数组组成的数组**（即嵌套一层），例如 [ [1,2], [3,4], [5] ]。它不会自动识别字段名、解析对象字段、或对非数组值做类型转换。如果你传入 { $concatArray: ["$tags", "$categories"] }，而 $tags 是字符串或 null，就会报错 concatArrays: expression must be an array。
- 常见错误现象：
TypeError: concatArrays requires an array as argument或聚合阶段直接失败 - 使用场景：想把文档中两个字段（如
$keywords和$synonyms）拼成一个去重标签列表 - 关键前提：每个待合并字段必须先确保是数组——用
$ifNull+$cond或$isArray做兜底
如何安全地合并两个可能为 null/缺失/非数组的字段？
必须显式处理每种异常情况，否则聚合会中断。推荐组合使用 $ifNull、$cond 和 $isArray：
{
$concatArray: [
{ $ifNull: ["$tags", []] },
{ $ifNull: ["$categories", []] }
]
}
-
$ifNull能覆盖字段缺失或为null的情况，但无法处理字符串或数字等非法类型 - 若字段可能是字符串（如
"tech,web"），需先用$split转成数组；若是对象，得用$objectToArray提取键或值 - 注意性能：嵌套多层
$cond判断会拖慢聚合，生产环境建议在写入时就规范字段类型
$concatArray 和 $setUnion 的核心区别在哪？
$concatArray 是拼接（保留重复、保持顺序），$setUnion 是并集（去重、无序）。别误以为加个 $setUnion 就能替代——它要求所有输入都是数组，且结果不保证顺序。
- 要保留原始顺序 + 允许重复 → 用
$concatArray - 要合并后去重（比如合并用户兴趣标签）→ 用
$setUnion，写法：{ $setUnion: ["$tags", "$categories"] } - 兼容性注意：MongoDB 4.4+ 才支持
$setUnion直接接收多个字段；旧版本需先$concatArray再$reduce+$setDifference
合并三个及以上数组时怎么避免手写冗长表达式？
没有语法糖，只能老老实实列出来，但可以借助变量减少重复判断：
{
$let: {
vars: {
safeTags: { $ifNull: ["$tags", []] },
safeCats: { $ifNull: ["$categories", []] },
safeAttrs: { $ifNull: ["$attributes", []] }
},
in: { $concatArray: ["$$safeTags", "$$safeCats", "$$safeAttrs"] }
}
}
- 用
$let预处理每个字段，比重复写$ifNull更清晰、易维护 - 字段超过 5 个时，要考虑是否设计不合理——数组字段过多往往意味着 schema 没做归一化
- 别忘了：所有被
$concatArray合并的数组，元素类型最好一致（比如全是字符串），否则排序、索引、查询时容易出隐性问题
$tags 在某些文档里是字符串，在另一些里是 null，甚至空对象。先做数据探查（db.collection.aggregate([{$limit:10}, {$addFields:{type:{$type:"$tags"}}}])），再动手写聚合。 
