MongoDB 5.0+ 不支持在线更换分片键，reshardCollection 是强制阻塞写入的命令，仅允许通过 mongos 执行，且不适用于 time-series 集合或含 _id 的分片键；refineCollectionShardKey 仅支持追加字段，不可更改主干结构。
MongoDB 5.0+ 不支持“在线更换分片键”——reshardCollection 是阻塞式操作，期间集合不可写，所谓“平滑”仅指无需停机重建集群，但业务写入必须暂停。
reshardCollection 命令会彻底阻塞写入
执行 reshardCollection 时，MongoDB 会锁定目标集合，所有 insert、update、delete 操作将被拒绝，返回错误：Command not supported on sharded collection while resharding。这不是资源竞争问题，而是设计上的强制限制。
常见误判场景：
- 误以为加了
--noIndexBuilds或调整maxTimeMS就能绕过阻塞 → 实际无效 - 在 mongos 上并发发起多个
reshardCollection→ 后续请求直接失败，不排队 - 试图用
refineCollectionShardKey替代重分片 → 它只允许向原分片键追加后缀字段（如从{a: 1}变为{a: 1, b: 1}），不能更改主干结构（如从{a: 1}改为{b: 1}）
reshardCollection 的真实前提条件
该命令不是“想换就换”，它依赖底层数据状态和集群健康度：
- 集合必须已分片（
sh.status()中可见），且不能是 time-series 集合（报错：Cannot reshard a time-series collection） - 目标新分片键必须满足：所有现有文档都包含该键的非空值；若字段缺失，reshard 会中止并提示
Document is missing shard key field - 所有分片的 CPU 负载建议低于 80%，否则可能触发超时（虽不强制，但
reshardCollection默认 30 分钟超时，且不可调） - 必须通过
mongos执行，直连分片节点会报错：not authorized on admin to execute command reshardCollection
真正可控的“低影响”方案：refine + 应用层双写过渡
如果你的目标是把 {region: 1} 换成 {tenant_id: 1, region: 1} 这类扩展场景，refineCollectionShardKey 是唯一安全路径：
先确认当前键可扩展：
db.runCommand({
refineCollectionShardKey: "mydb.sales",
key: { tenant_id: 1, region: 1 }
})
但注意：
- refine 不移动数据，只更新元数据和路由表，因此毫秒级完成
- 之后插入/更新必须提供完整新键（
tenant_id不能为null），否则写入失败：shard key cannot be null - 旧文档仍按原
{region: 1}路由，新键仅影响新增文档 —— 所以需配合应用层双写（同时写旧结构+新结构）或批量补全脚本
容易被忽略的细节：_id 字段与分片键的耦合风险
如果原分片键含 _id（例如 {_id: "hashed"}），你无法通过 reshardCollection 改为 {user_id: 1}，因为 _id 是不可变字段，且 MongoDB 禁止删除或覆盖它作为分片键的一部分。此时唯一出路是导出-重建-导入，reshardCollection 直接报错：cannot change shard key that includes _id field。别指望后台自动处理，这个限制硬编码在分片元数据校验逻辑里。
