不能直接用country字段作分片键，因其基数低（仅约200个国家）且存在写入热点（如中、印、美），易导致chunk搬迁风暴；应采用{country: 1, _id: "hashed"}复合键配合zone+range实现物理隔离与负载均衡。
为什么不能直接用 shard key 做国家字段路由
很多用户一上来就想把 country 字段设为分片键，认为这样写入自然就落到对应区域的分片上。但实际会遇到两个硬伤：一是高基数低区分度（全球国家才200多个，而分片数可能远超这个数），二是写入热点（如中国、印度、美国流量集中，导致某几个分片持续过载）。MongoDB 要求分片键必须有足够离散性，且不能是单调递增或低基数字段——否则 shard key 会触发 chunk 搬迁风暴，甚至卡死 balancer。
用 zone + range 或 hash 组合实现物理隔离
真正可行的方案是：先定义 zone 映射国家范围，再让分片键携带可路由信息。关键不在于“写入时指定分片”，而在于让 MongoDB 路由层能根据文档内容自动匹配到预设 zone。
- 先为每个地理区域创建 zone：
sh.addShardTag("shard01", "CN")、sh.addShardTag("shard02", "US") - 再绑定范围（推荐）：
sh.updateZoneKeyRange("db.collection", { country: "CN" }, { country: "CN" }, "CN")—— 注意：这仅在country是分片键前缀且类型支持 range（如字符串）时有效 - 更稳妥的做法是用复合分片键：
{ country: 1, _id: "hashed" }，然后对country字段建 zone + range，MongoDB 会优先按前缀匹配 zone，再用 hash 均摊同 country 内的写入压力
mongos 路由失效的典型表现和自查点
即使配置了 zone 和 range，写入仍可能打到错误分片，常见于以下情况：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 插入文档未包含
country字段，或值为空/空字符串/非预期格式（如"china"vs"CN"），导致无法匹配任何 zone，回落至默认分片 - 执行
sh.status()后发现tags列没显示生效，说明addShardTag后没执行updateZoneKeyRange，或者 range 边界写错了（比如用了{ country: { $gte: "CN" } }这种非法语法） - 应用直连了某个
mongod而非mongos，绕过了路由逻辑——检查连接字符串是否含mongos地址和端口（默认 27017），而非单个 shard 的地址
写入前强制校验与 fallback 机制怎么加
MongoDB 不提供“写入失败即重试到指定分片”的 API，所以必须在应用层兜底：
- 插入前校验
country值是否在白名单内（如["CN", "US", "JP", "DE"]），非法值直接拒绝或打日志告警 - 对关键业务文档，可加一个
region_hint字段（如"cn-east"），并在应用里维护region_hint → zone映射表，用于 debug 和灰度切换 - 监控
sh.status()中各 shard 的chunks分布，以及db.collection.stats().sharded返回的indexDetails是否包含分片键索引——缺失索引会导致路由降级为 broadcast
zone 路由不是银弹，它依赖分片键设计、数据分布和 balancer 状态三者稳定；一旦某 shard 宕机或 chunk 迁移中，写入延迟和重试行为会变复杂，这些边界情况比配置本身更值得盯紧。
