MongoDB Nullable unique index存多null值报错解决方案

MongoDB默认唯一索引会将null视为合法的可索引值，多文档同字段存null时会触发唯一约束冲突。配置sparse: true的稀疏索引仅会跳过索引字段完全不存在的文档，只要文档中显式声明了目标字段、哪怕值为null，依然会被纳入索引校验范围，因此无法适配字段显式存null的场景。

方案1：使用部分索引（推荐，适配绝大多数场景） #

MongoDB 3.2及以上版本支持部分索引，可在创建唯一索引时通过partialFilterExpression配置索引过滤规则，仅对目标字段值非null的文档做唯一性校验，字段值为null、或字段不存在的文档都不会被纳入索引约束范围，完全匹配需求。
创建索引示例命令：

db.你的集合名.createIndex(
  { 目标字段名: 1 }, // 1为升序索引，-1为降序，可根据查询需求调整
  {
    unique: true,
    partialFilterExpression: { 目标字段名: { $ne: null } }
  }
)

操作注意：

• 新索引创建前需要先删除旧的冲突唯一索引，否则原有约束依然生效
• 建索引前需确认集合内已存在的文档中，目标字段的非null值没有重复，否则索引会创建失败

方案2：调整存储逻辑，不显式存储null值 #

如果使用的MongoDB版本低于3.2、无法使用部分索引，可以在数据写入层做逻辑判断：当目标字段不需要赋值时，直接不在文档中写入该字段，而非显式赋值为null。配合sparse: true的唯一索引即可绕过重复校验。
该方案对业务查询的影响极小：MongoDB查询不存在的字段时，默认返回值就是null，仅需注意业务查询时不要额外添加{目标字段: {$exists: true}}的过滤条件即可。

方案3：特殊占位值替代null（不推荐） #

可给无有效值的文档分配唯一的特殊占位值（比如拼接随机串、ObjectId的特殊标识）存入目标字段，绕过唯一约束。但该方案会污染业务字段的取值域，后续查询、统计、数据校验都需要额外加逻辑排除占位值，维护成本极高，仅在前两种方案都无法落地时作为临时兜底方案。

内容的提问来源于stack exchange，提问作者weera