唯一索引在分片集群中必须以分片键为前缀,否则无法跨分片原子校验唯一性;mongos只能将请求路由至单个分片,若索引不含分片键前缀,则重复值可能散落多分片且不报错。

唯一索引在分片集群里为什么必须以分片键为前缀
因为 MongoDB 无法跨分片原子校验唯一性——它只能把写入请求路由到单个分片执行,而这个路由动作依赖索引字段是否能被 mongos 精确推导出目标分片。如果 unique 索引不含分片键或其前缀,mongos 就不知道该把“插入 email='a@b.com'”的请求发给哪个分片,只能任选一个;那个分片只查自己数据,漏掉其他分片已存在的重复值。
不带分片键前缀的 createIndex({email: 1}, {unique: true}) 会怎样
命令通常成功返回,但实际无效:
- 插入重复
email不报错,数据可能散落在多个分片上 -
explain()显示查询走SHARD_MERGE+COLLSCAN,性能归零 - 索引仅在各分片本地生效,等价于 N 个独立集合各自建了唯一索引
- 即使后续补上分片键索引,也不会自动激活全局唯一约束
哪些索引结构能真正支持全局唯一
必须满足“分片键可路由 + 唯一性可下推”两个条件:
- 分片键是
{orgId: 1}→ 允许createIndex({orgId: 1, email: 1}, {unique: true}) - 分片键是
{tenantId: 1, createdAt: -1}→ 允许{tenantId: 1, email: 1},但禁止{createdAt: -1, email: 1}(顺序错)和{email: 1}(无前缀) - 哈希分片键如
{userId: "hashed"}→ 不能 创建任何unique: true索引,MongoDB 直接拒绝 - 复合索引中分片键字段必须严格按定义顺序和方向出现,不能稀疏、不能唯一(除非是
_id)
绕过限制的替代方案有哪些
当业务强要求非分片键字段唯一(比如 email),又不能改分片键时,只能应用层兜底:
- 用单独的“唯一性代理集合”,存
{email: "...", docId: ObjectId(...)},对该集合以email建唯一索引并分片 - 写入前先查代理集合,命中则拒绝;写入主集合后,再原子写入代理集合(需事务或两阶段提交)
- 放弃 MongoDB 原生唯一保证,改由业务服务做分布式锁 + 缓存预检(如 Redis SETNX)
- 注意:
partialFilterExpression无法挽救这个问题,局部索引仍受分片键路由规则约束
{_id: "hashed"} 都不例外。


















