Zone Sharding 的本质是数据物理路由,需通过 sh.addShardToZone 绑定分片与 zone、sh.addTagRange 定义数据范围,并确保分片键含非空 zone 字段,同时关闭 balancer 以防止破坏分布。

Zone Sharding 的本质是数据物理路由,不是读写偏好
很多人误以为 zone 能直接让客户端“读本地”,其实不是。zone 只控制数据**存到哪几个 shard 上**,不控制查询发给哪个 mongos 或走哪个副本集节点。真正实现“本地化读写”,必须配合应用层路由(比如按用户归属地选 mongos 实例)+ readPreference + zone 配置三者协同。否则即使数据在杭州机房的 shard 上,请求从北京 mongos 进来,依然要跨机房转发。
必须先用 sh.addShardToZone() 绑定分片与区域
Zone Sharding 不是开个开关就生效的,核心动作是把物理 shard 和逻辑 zone 关联起来。常见错误是只调了 sh.addTagRange() 却忘了绑定 shard —— 这会导致 chunk 无法迁入目标区域,后续所有操作都无效。
-
sh.addShardToZone("shard01", "hz"):把 shard01 标记为属于 “hz”(杭州)区域 -
sh.addTagRange("mydb.mycoll", { region: "hz" }, { region: "hz" }, "hz"):声明 region="hz" 的文档应落在 "hz" zone 内 - 一个 shard 可以属于多个 zone,但一个 zone 至少要关联一个 shard,否则 range 无法落地
分片键必须包含 zone 字段,且不可为空
如果用 { region: 1, _id: 1 } 作分片键,但部分文档 region 是 null 或缺失,这些文档会被统一打到一个“默认 chunk”,容易成为热点,且无法被 zone 规则覆盖。MongoDB 不会自动补全或忽略缺失值。
- 写入前必须确保
region字段存在且有明确值(如 "bj"、"sh"、"hz") - 避免用稀疏索引或可空字段做 zone 相关分片键成分
- 上线前用
db.mycoll.find({ region: null }).count()检查脏数据
Balancer 会破坏手动 zone 分布,需谨慎开关
默认开启的 balancer 在检测到 chunk 数量不均时,会无视 zone 约束强行迁移 —— 这是 Zone Sharding 最常被踩的坑。一旦发生,你精心规划的地域分布就乱了。
- 启用 zone 后,务必执行
sh.disableBalancing("mydb.mycoll")关闭该集合的 balancer - 需要重新均衡时,改用
sh.moveChunk()手动迁移,并确认目标 shard 已绑定对应 zone - 不要依赖
sh.setBalancerState(false)全局关闭,会影响其他非 zone 集合
region 字段写错或 shard 绑定遗漏,后续几乎无法热修复 —— 很多团队最后不得不导出再重分片。


















