MongoDB聚合管道中$sqrt是原生一元表达式操作符，仅支持非负数字字段开方，需前置类型校验与负数处理，不支持字符串、null、数组或负数，错误时报“can't take sqrt of negative number”。
聚合管道里直接用 $sqrt 计算平方根，但字段必须是数字且非负
$sqrt 是 MongoDB 原生聚合阶段支持的算术表达式操作符，作用明确：对单个数值字段或表达式结果开平方根。它不接受字符串、null、缺失字段或负数——遇到这些会直接报错 errmsg: "can't take sqrt of negative number" 或静默返回 null（取决于 MongoDB 版本和上下文），所以前置校验很关键。
典型写法是在 $project 或 $addFields 阶段使用：
{
$addFields: {
distance_sqrt: { $sqrt: "$distance_squared" }
}
}
其中 $distance_squared 必须是已存在的数值型字段，且所有文档该字段值 ≥ 0。
- 如果源字段是字符串（如
"16"），需先用$toDouble或$toInt转换，否则$sqrt会失败 - 若字段可能为
null或缺失，建议包裹一层$ifNull或$cond做兜底，比如{ $sqrt: { $ifNull: ["$score", 0] } } - 负数场景常见于计算误差或未过滤的中间结果，推荐在
$sqrt前加$max: ["$value", 0]强制归零，避免中断整个聚合
为什么 $sqrt 不支持数组或多个参数
$sqrt 是一元操作符，语法严格限定为 { $sqrt: ，不能写成 { $sqrt: ["$a", "$b"] } 或对数组整体开方。如果要对数组每个元素开方，得用 $map 包裹：
{
$addFields: {
roots: {
$map: {
input: "$numbers",
as: "n",
in: { $sqrt: "$$n" }
}
}
}
}
这里 $$n 是当前迭代变量，$sqrt 对每个元素单独作用。注意：$numbers 数组内每个值仍需满足非负+数字类型，否则对应位置结果为 null。
- 误写成
{ $sqrt: "$numbers" }会导致整个表达式求值失败（MongoDB 6.0+ 报错，旧版可能静默返回null） - 若数组含混合类型（如
[4, "9", -1]），$sqrt在$map内对"9"会失败，对-1也会失败——需要在外层再加类型/符号检查
$sqrt 和 JavaScript 的 Math.sqrt() 行为基本一致，但无浮点精度控制
MongoDB 内部使用 IEEE 754 双精度浮点实现 $sqrt，结果与 Node.js 中 Math.sqrt() 对同一输入几乎完全一致（极小误差可忽略）。但它不提供类似 toFixed() 或舍入控制，结果默认保留完整浮点精度。
如需四舍五入或截断，得组合其他操作符：
{
$addFields: {
rounded_root: { $round: [{ $sqrt: "$x" }, 2] }
}
}
-
$round是 MongoDB 4.2+ 支持的配套操作符，第二个参数指定小数位数 - 不要试图用
$multiply+$trunc模拟，既冗余又易出错（比如负数处理逻辑复杂） - 性能上，
$sqrt是原生 C++ 实现，比在应用层取回数据再计算快得多，尤其面对百万级文档时优势明显
聚合中调试 $sqrt 报错的最快方式
当聚合因 $sqrt 中断时，错误信息往往只提示“invalid argument”，不指明具体哪条文档出问题。最有效的排查路径是分步隔离：
- 先用
$match过滤出疑似问题子集，例如{ distance_squared: { $lt: 0 } }找负数 - 用
$facet同时跑两路：一路走正常$sqrt，另一路用$type检查字段类型，对比输出差异 - 临时把
$sqrt替换为$cond做防御性计算，例如：{ $cond: [{ $and: [{ $gte: ["$v", 0] }, { $isNumber: "$v" }] }, { $sqrt: "$v" }, null] }
真正容易被忽略的是：某些驱动（如 PyMongo）在聚合报错时可能吞掉原始错误码，建议直接在 mongosh 里复现聚合管道，看完整 errmsg —— 很多时候问题不在 $sqrt 本身，而在上游阶段意外生成了 NaN 或 Infinity。
