$concat是mongodb聚合中唯一原生多字段字符串拼接操作符，但要求所有参数必须为字符串，遇null、数字或缺失字段时返回null或报错16702，需用$tostring和$ifnull显式兜底处理。
$concat 是 MongoDB 聚合中唯一原生支持多字段字符串拼接的管道操作符，但它对输入类型极其敏感——只要任一参数不是字符串（包括 null、number、missing field），整个表达式就失败或返回 null，而不是静默转换。
为什么 $concat 会突然返回 null 或报错
它不自动做类型转换，也不跳过无效值。常见触发场景：
-
"$description"字段值为null或根本不存在 → 结果为null -
"$score"是数字类型（比如95）→ 报错："$concat only supports strings, not double"，错误码16702 - 字段名写错，如误写成
"$descripton"（少个 i）→ 引用缺失字段 → 返回null - 混用了数组或嵌套对象（如
"$tags"是数组）→ 报错或结果不可预期
如何安全地拼接，避免 null 和类型错误
必须显式兜底：把非字符串字段转成字符串，并处理 null 和缺失情况。核心靠 $toString + $ifNull 组合：
db.inventory.aggregate([
{
$project: {
itemDescription: {
$concat: [
{ $ifNull: [{ $toString: "$item" }, ""] },
" - ",
{ $ifNull: [{ $toString: "$description" }, "N/A"] }
]
}
}
}
])
说明：
-
$toString可安全转换number、boolean、null（转成字符串"null"）等，但对缺失字段仍返回null -
$ifNull: ["$field", "default"]能同时捕获null值和缺失字段，推荐作为前置保护 - 不要依赖客户端或应用层“先查再拼”，聚合阶段就要一次性处理干净
$concat 只能在 $project / $addFields / $set 中使用
它不是查询过滤器，也不能直接用于 find() 的 filter 参数里。常见误用：
- 错：
db.col.find({ name: { $concat: ["Mr. ", "$firstName"] } })→ 语法非法，$concat不在查询表达式支持范围内 - 对：用
$project先生成新字段，再在后续阶段（如$match）中过滤该字段 - 更新场景中可用：例如
$set: { fullName: { $concat: ["$first", " ", "$last"] } }是合法的
替代方案：什么时候不该硬用 $concat
如果目标是模糊搜索或条件匹配，拼接后查反而低效。例如想查 “姓张且名字含‘伟’” 的人：
- ❌ 错误思路：先
$project拼出fullName，再$match: { fullName: /张.*伟/ }→ 失去索引能力，全表扫描 - ✅ 正确做法：直接
$match: { firstName: "张", lastName: /伟/ }，或用$regex分别作用于原字段 - 只有当拼接结果需存档、导出、或作为下游计算输入时，才值得在聚合中执行
真正容易被忽略的是：$concat 的失败不是静默的——它要么返回 null（看起来像“没数据”），要么直接中断整个聚合并抛错。上线前务必用含 null、数字、缺失字段的真实样例验证 pipeline。
