$concat是MongoDB聚合中唯一原生多字段字符串拼接操作符,但要求所有参数必须为字符串,遇null、数字或缺失字段时返回null或报错16702,需用$toString和$ifNull显式兜底处理。
$concat 是 MongoDB 聚合中唯一原生支持多字段字符串拼接的管道操作符,但它对输入类型极其敏感——只要任一参数不是字符串(包括 null、number、missing field),整个表达式就失败或返回 null,而不是静默转换。
它不自动做类型转换,也不跳过无效值。常见触发场景:
"$description" 字段值为 null 或根本不存在 → 结果为 null
"$score" 是数字类型(比如 95)→ 报错:"$concat only supports strings, not double",错误码 16702
"$descripton"(少个 i)→ 引用缺失字段 → 返回 null
"$tags" 是数组)→ 报错或结果不可预期必须显式兜底:把非字符串字段转成字符串,并处理 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 值和缺失字段,推荐作为前置保护它不是查询过滤器,也不能直接用于 find() 的 filter 参数里。常见误用:
db.col.find({ name: { $concat: ["Mr. ", "$firstName"] } }) → 语法非法,$concat 不在查询表达式支持范围内$project 先生成新字段,再在后续阶段(如 $match)中过滤该字段$set: { fullName: { $concat: ["$first", " ", "$last"] } } 是合法的如果目标是模糊搜索或条件匹配,拼接后查反而低效。例如想查 “姓张且名字含‘伟’” 的人:
$project 拼出 fullName,再 $match: { fullName: /张.*伟/ } → 失去索引能力,全表扫描$match: { firstName: "张", lastName: /伟/ },或用 $regex 分别作用于原字段真正容易被忽略的是:$concat 的失败不是静默的——它要么返回 null(看起来像“没数据”),要么直接中断整个聚合并抛错。上线前务必用含 null、数字、缺失字段的真实样例验证 pipeline。