$split仅在aggregate()的$set/$project/$addFields阶段生效，不能用于find()或普通update；需确保输入为字符串字段，建议用$toString和$ifNull做类型保护。
为什么 $split 在聚合管道里不生效？
直接在 find() 中用 $split 会报错：它不是查询操作符，只存在于聚合管道（aggregate()）中。常见错误是写成 { tags: { $split: [ "$str", "," ] } } 放进 find()，结果得到 unknown operator: $split。
必须用 aggregate()，且只能在 $project、$addFields 或 $set 阶段使用。
-
$split要求第一个参数是字符串字段（如"$field"），不能是字面量字符串（如"abc,def"）——MongoDB 会静默返回null - 如果源字段为
null、missing或非字符串类型，$split返回null，不是空数组 - 分隔符不能为空字符串；传入
""会报错Regular expression is invalid: empty string
怎么安全地把 "a,b,c" 变成 ["a","b","c"]？
最简可行写法：
db.collection.aggregate([
{
$set: {
tags: { $split: ["$str", ","] }
}
}
])
但要注意边界情况。如果 str 字段可能为空、null 或数字，建议加一层类型保护：
- 用
$toString强转再拆分：{ $split: [{ $toString: "$str" }, ","] } - 用
$ifNull提供默认空字符串：{ $split: [{ $ifNull: ["$str", ""] }, ","] } - 想过滤掉空项（比如
"a,,b"拆出["a","","b"]），得额外接$filter，$split本身不处理
$split 和 JavaScript 的 split() 行为一致吗？
基本一致，但关键差异在于对重复分隔符的处理：MongoDB 的 $split 不压缩连续分隔符。例如 "a,,b" 拆出来是 ["a", "", "b"]，不是 ["a","b"]。
另外，它不支持正则表达式分隔符（比如按空白字符或多种符号拆），只接受字面量字符串。想实现类似 /[,;\s]+/g 的效果，得先用 $replaceAll 归一化分隔符，再 $split。
- 想把逗号、分号、空格都当分隔符？先
$replaceAll全换成逗号，再$split - 想保留原始字段同时新增数组字段？用
$addFields，别覆盖原字段名 - 在 MongoDB 4.2+ 才支持
$split；4.0 及以下版本需用应用层处理
更新文档时能直接用 $split 吗？
不能。更新操作（updateOne、updateMany）不支持聚合表达式（除非用 pipeline 形式的更新，即 MongoDB 4.2+ 的新语法）。常见误写：{ $set: { arr: { $split: ["$str", ","] } } } 在普通 update 中无效。
正确做法分两步：
- 查出来 → 应用层用 JS/Python 拆分 → 再
updateOne写回 - 或改用聚合更新（
updateMany第二个参数传 pipeline）：{ updateMany: { pipeline: [ { $set: { arr: { $split: ["$str", ","] } } } ] } }
后者要求驱动和服务器都支持 4.2+，且注意 pipeline 更新无法使用 $set 直接引用其他字段的旧值（如 "$oldArr"），必须用 $mergeObjects 等组合。
实际用的时候，最容易漏掉的是字段类型校验和空值兜底——$split 看似简单，但线上数据往往混着 null、number、空格字符串，一拆就丢数据。
