分片键基数低导致chunk无法分裂:因分片键取值离散度不足(如全相同或仅少数值),MongoDB找不到split point,使chunk数长期不增;验证需聚合统计分片键分布,重建分片须停写并用mongodump/mongorestore更换复合键。

分片键基数低导致 chunk 无法分裂:现象和定位
当你看到 sh.status() 中某个 shard 上的 chunk 数长期不增长,甚至所有 chunk 都卡在同一个 shard(比如 shard0000),且 db.collection.stats().sharded 返回 true、但 chunks 数极少(比如始终是 1 或 2),基本就是分片键基数太低——MongoDB 根本分不出新 chunk。
根本原因:chunk 分裂依赖「分片键取值的离散程度」。如果大量文档的分片键值完全相同(如全用 "status": "active"),或者只有极少数取值(如只有 3 种 region),MongoDB 就找不到合适的 split point,moveChunk 和自动分裂都会静默失败。
验证方式:运行 db.collection.aggregate([{$group: {_id: "$your_shard_key", count: {$sum: 1}}}, {$sort: {count: -1}}, {$limit: 5}]),看前几项是否占总量 80%+。
加复合分片键前必须停写并预估分布
直接在运行中的集合上修改分片键是不可能的——sh.shardCollection() 只能调用一次,且不可更改。所以“加复合字段”本质是重建分片:先 dump 数据,改键,再 restore。过程中必须停写,否则数据不一致。
- 停写不是“暂停应用”,而是确保没有
insert/update触及该集合,否则 dump 和 restore 之间会丢数据 - 新复合键要满足两个硬条件:
cardinality > document_count / 100(理想是 > ×10),且字段本身写入时就存在、不可为空(null或缺失会导致 chunk 归到minKey,加剧倾斜) - 避免用时间戳单独做前缀(如
{ts: 1, _id: 1}),高并发写入下前几秒的 ts 完全相同,仍会扎堆;建议用{region: 1, _id: 1}或{userIdMod100: 1, createdAt: 1}
实际重建分片的三步操作(以 mongodump + mongorestore 为例)
别信“在线重分片”方案,社区版没这功能,4.4+ 的 reshardCollection 也要求原分片键能被新键完全覆盖,且期间禁止写入——和 dump/restore 没本质区别,但更难 debug。
- 用
mongodump --host old_rs --db mydb --collection users --out ./backup导出全量 - 删掉旧集合:
sh.stopBalancer(); db.users.drop(); sh.removeShard("shard0000")(注意:removeShard 是为清空旧分片状态,不是删数据) - 用新键重新分片:
sh.shardCollection("mydb.users", {"region": 1, "_id": 1}),再mongorestore --host new_cluster --dir ./backup/mydb/users.bson
关键细节:mongorestore 默认不保留 ObjectId 创建时间,如果新键含 _id,必须加 --maintainInsertionOrder,否则批量插入可能打乱自然顺序,让 chunk 初始分布不均。
为什么不能只加索引或改查询模式来绕过?
有人想“我不动分片键,只给其他字段加索引,让查询变快”——这解决不了 chunk 倾斜。分片逻辑只认分片键,查询走不走索引、有没有聚合管道,都不影响 chunk 如何切分和迁移。Balancer 只根据 chunk 大小(默认 64MB)和分片键范围分裂,跟查询性能无关。
另一个常见错觉是“用 hashed 分片键能自动均匀”。但 {"region": "hashed"} 依然只有 3 个取值 → 只产生 3 个 hash 桶 → 最多 3 个 chunk。基数低,hash 也救不了。
真正容易被忽略的是:复合键里第二个字段的分布必须“在第一个字段的每个取值下都足够散”。比如 {country: 1, city: 1},如果某 country 下 90% 的 city 都是 "Beijing",那这个 country 分区还是会倾斜。得提前抽样验证交叉分布。










