$map + $concat 组合常因数组元素非字符串（如null、数字）导致返回null，须用$toString显式转换并配合$cond过滤空值，否则静默失败。
为什么 $map + $concat 组合常返回 null 或报错
直接套用 $map 包裹 $concat 却得不到预期字符串，多数是因为 $concat 的参数必须是字符串类型，而数组元素可能是 null、missing 或数字——MongoDB 不会自动转类型，一碰到非字符串就整个 $concat 返回 null。
典型错误写法：
{ $map: { input: "$tags", as: "t", in: { $concat: ["[", "$$t", "]"] } } } 当 $tags 里有 null 或 42，$concat 就静默失败。
- 确保每个输入都显式转成字符串：用
$toString包一层（4.0+） - 过滤掉空值更安全：加
$cond判断$$t是否存在且非空 - 注意
$concat只接受字符串数组，不能传对象或嵌套表达式（比如{ $concat: "$$t" }是错的）
正确写法：带类型保护的 $map + $concat 模板
这是生产环境推荐的写法，兼顾健壮性和可读性：
{
$map: {
input: "$tags",
as: "t",
in: {
$concat: [
"[",
{ $toString: "$$t" },
"]"
]
}
}
}
如果字段可能为 null 或缺失，进一步加固：
{
$map: {
input: "$tags",
as: "t",
in: {
$cond: {
if: { $ne: ["$$t", null] },
then: { $concat: ["[", { $toString: "$$t" }, "]"] },
else: ""
}
}
}
}
-
$toString对null返回"null"，所以仍需$cond控制逻辑分支 - 别用
$ifNull替代$cond：它只能设默认值，无法跳过拼接 - 若原始数组含对象（如
{name: "a"}），需先用$getField或$toString转成 JSON 字符串再拼
在 $project 和 $set 中的实际位置与性能影响
这个组合通常出现在聚合管道的 $project 或 $set 阶段。放在 $set 更清晰（语义是“新增/覆盖字段”），但要注意顺序：
- 不能在
$group后直接对未保留的数组字段用$map——得先在$group里用$push显式收集成数组 - 若数组很大（>1000 元素），
$map会逐项计算，无索引加速，属于 CPU 密集型操作；考虑前置过滤（$filter）缩小输入规模 - 在
$project中使用时，避免同时投影大量无关字段，减少 BSON 传输体积
替代方案：什么时候不该硬套 $map + $concat
如果目标只是给每个字符串加前后缀，且数组结构简单，$map 是合适选择；但以下情况建议换思路：
- 需要连接成单个字符串（如
"[a],[b],[c]"）：改用$reduce+$concat，或先$map再$reduce - 前缀/后缀本身是动态字段（如
"[" + "$prefix" + "$$t" + "$suffix" + "]"）：确认$prefix在当前作用域可见，否则要提前用$let绑定 - 仅需格式化少数固定字段（如只处理
name和code）：直接写两个独立$concat表达式，比$map更轻量
最易被忽略的一点：聚合阶段不支持正则替换或大小写转换等复杂字符串操作，$concat 只负责拼，加工得靠 $toUpper、$replaceAll 等前置处理——这些都要包在 $map 的 in 表达式里，层层嵌套时括号和逗号极易出错。
