$isArray（判断值是否为数组）
最后更新：2026-10-09
$isArray（判断值是否为数组）
$isArray 判断表达式结果是否为数组，返回布尔值。它常用于 $cond 中做类型分支：字段可能是标量也可能是数组时，先判断再决定处理路径；也能用来保护 $size/$map 等只接受数组的操作符，避免报错。它是聚合表达式里的类型守卫，与 $type 配合可以精确区分 BSON 类型。字段缺失时返回 false 而不是报错。
| 分类 | 数组 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $isArray: <表达式> }⚙️ 参数
| 表达式 | 任意表达式，判断其结果是否为数组。 |
|---|
返回值：布尔值：结果是数组返回 true，否则返回 false
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $isArray：tags 可能是字符串或数组，统一统计
db.products.aggregate([
{ $project: {
tagCount: { $cond: { if: { $isArray: '$tags' }, then: { $size: '$tags' }, else: 1 } }
} }
])运行结果：
{ '_id': 1, 'tagCount': 3 }
{ '_id': 2, 'tagCount': 1 }📌 注意事项
- 字段缺失时返回 false，不会报错
- 嵌套数组（数组里的数组）也算数组，$isArray 返回 true
- 常与 $cond/$switch 组合做类型分派，避免对非数组调用 $size 报错
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q字段不存在时 $isArray 返回什么？
A返回 false，不会报错，适合做安全判断。
Q$isArray 能区分字符串和字符数组吗？
A能，字符串不是数组返回 false；只有 BSON Array 类型才返回 true。
Q怎么和 $cond 配合使用？
A把 $isArray 放在 $cond 的 if 位置，then/else 写两条处理分支即可。
