MongoDB唯一索引默认跳过null和undefined值，不参与唯一校验；需用partialFilterExpression配合unique或sparse索引实现空值约束。
唯一索引遇到 null 值会怎样？
MongoDB 的唯一索引默认允许任意数量的 null 值——只要字段缺失或显式设为 null，这些文档就“不参与唯一性校验”。这不是 bug，是设计行为：MongoDB 把 null 视为“缺失值”的等价表示，而唯一约束只作用于**存在且非 null 的值**。
常见错误现象：
插入多条 { email: null } 或 { email: undefined } 文档不报错，但业务上你可能期望“空邮箱也得唯一”（比如防重复注册时未填邮箱的用户）。
- 如果字段是可选的，又想对“有值的部分”强制唯一、同时禁止多个空值，不能只靠
unique: true -
undefined和null在索引中表现一致，都跳过唯一检查 - 嵌套字段如
"profile.email"中profile为null时，整个路径视为缺失，同样绕过约束
稀疏索引（sparse: true）能解决什么问题？
稀疏索引只索引**至少有一个非 null 值的字段路径**的文档。它和唯一索引组合（{ unique: true, sparse: true }）后，效果是：“所有该字段有值的文档，值必须唯一；字段为空的文档，直接不进索引，也不被约束”。
使用场景：
比如用户表中 phone 是可选字段，你只希望已填写的手机号不重复，但允许多个用户没填——这时 { phone: 1, unique: true, sparse: true } 正合适。
- 稀疏索引不会索引
{ phone: null }、{}、{ phone: undefined }这类文档 - 但它依然无法阻止多个
{ phone: null }插入——因为它们根本不在索引里，自然不触发唯一冲突 - 注意兼容性：在分片集群中，稀疏索引要求所有分片键字段都出现在索引中，否则建索引会失败
真正阻止多个 null 的办法：用部分索引（partialFilterExpression）
如果你需要“字段为 null 也算一种值，且必须唯一”，唯一可靠的方式是用部分索引 + 显式匹配 null，再配合唯一性。例如：
db.users.createIndex(
{ email: 1 },
{
unique: true,
partialFilterExpression: { email: { $type: "null" } }
}
)
这行命令的意思是：“所有 email 字段类型为 null 的文档，其 email 值必须唯一”——而 null 只有一个值，所以最多只能有一条这样的文档。
- 要同时约束“非空值唯一”和“空值唯一”，需建两个索引：
•{ email: 1, unique: true }（覆盖非空）
•{ email: 1, unique: true, partialFilterExpression: { email: { $type: "null" } } }（覆盖空） -
$type: "null"匹配的是显式null，不匹配字段缺失（{}）；若也要覆盖缺失，得加$exists: false条件，但此时无法与唯一性共存（MongoDB 不允许部分索引中$exists: false和unique同时出现） - 部分索引从 MongoDB 3.2 起支持，旧版本不可用
实际建索引前必须确认的三件事
线上集合已有数据时，建唯一索引会失败（如果存在重复值），而 null 相关逻辑会让问题更隐蔽。
- 先查有没有意外重复：
db.users.aggregate([ { $group: { _id: "$email", count: { $sum: 1 } } }, { $match: { count: { $gt: 1 } } } ])—— 注意结果里_id: null表示多个null值 - 确认应用层是否真把
undefined当作有意图的“空”，还是应该统一转成null或删掉字段；混用会导致索引行为不一致 - 如果用 ODM（如 Mongoose），检查 schema 是否启用了
minimize: true（默认开启），它会自动删掉undefined字段，导致你以为写了undefined，实际存的是字段缺失——而这在稀疏索引里是被忽略的
最麻烦的不是语法怎么写，而是你得先厘清业务语义：那个“空”，到底是“尚未提供”，还是“明确声明为空”，或是“根本不适用”。MongoDB 的索引机制不会替你做这个判断。
