分片失败卡在moveChunk阶段的根本原因是文档体积超出MongoDB对chunk内文档数量和大小的硬性约束。大文档（如几十MB）导致内存、网络或超时问题，触发“Cannot move chunk”等错误；jumbo chunk需手动split并调用sh.removeJumbo清除标记，不能仅靠调大chunkSize解决。
分片失败直接卡在 moveChunk 阶段，根本原因是文档体积超出了 MongoDB 对单个 chunk 内文档数量和大小的硬性约束，不是配置能调出来的“软问题”。
为什么大文档会让 moveChunk 失败
当 chunk 中存在远超平均大小的文档（比如几十 MB 的二进制或嵌套深的 JSON），moveChunk 会因内存、网络传输或超时限制直接中止。典型错误日志里会出现：Cannot move chunk: the maximum number of documents for a chunk is xxx 或 OperationFailed: Data transfer error: migrate failed。这不是均衡器 bug，而是设计限制——MongoDB 要求 chunk 拆分/迁移必须可预测、可中断、可回滚，大文档破坏了这个前提。
确认是否真由大文档触发
别急着删数据，先定位问题源头：
- 执行
sh.status(true)，看输出里是否有jumbo: true的 chunk； - 连到 config server 主节点，查
db.chunks.find({jumbo: true})，确认具体库/集合/范围； - 挑一个 jumbo chunk 的
min和max值，去源分片上运行：db.<collection_name>.find({<shard_key>: {$gte: min_val, $lte: max_val}}).sort({$natural: -1}).limit(1).pretty()</shard_key></collection_name>，观察单文档大小（Object.bsonSize(doc)）； - 如果单文档 > 16MB（BSON 限制），那它根本存不进 MongoDB，分片前就该报错；若在 2–16MB 区间，则是迁移阶段的现实瓶颈。
绕过 jumbo chunk 的实操路径
不能靠调大 chunkSize 解决——jumbo 是标记，不是尺寸阈值。真正可行的是让 chunk “可分割”：
- 停均衡器：
sh.stopBalancer()，避免自动操作干扰； - 手动 split chunk：
sh.splitAt("db.collection", {<shard_key>: <split_value>})</split_value></shard_key>，选一个能避开大文档边界的值（比如大文档的 shard key 值本身）； - 如果 splitAt 报错说无法分割（
cannot split chunk containing jumbo documents），说明该 chunk 里所有文档都挤在同一个 shard key 值附近，此时必须先改数据分布：用db.collection.updateMany()微调部分文档的 shard key 字段（加随机后缀、哈希截断等），再重试 split； - 成功 split 后，再用
sh.moveChunk()逐个迁移小 chunk，而不是等均衡器批量处理。
长期规避：分片键设计与写入控制
事后补救成本高，关键在预防。大文档问题往往暴露分片键缺陷：
- 避免用低基数字段（如状态枚举、布尔值）作分片键，否则所有大文档全堆在一个 chunk；
- 对已知含大文档的集合，优先用哈希分片（
sh.shardCollection("db.coll", {"field": "hashed"})），强制分散； - 应用层写入前做校验：
if (Object.bsonSize(doc) > 8 * 1024 * 1024) { /* 拒绝或走单独大对象存储 */ }； - 定期跑脚本扫描：
db.collection.find().limit(10000).forEach(doc => { if (Object.bsonSize(doc) > 4 * 1024 * 1024) printjson({ _id: doc._id, size: Object.bsonSize(doc) }) })，比等故障更主动。
最易被忽略的一点：jumbo chunk 不会自动消失，即使你删了里面的大文档，config server 仍标记它为 jumbo，后续所有涉及该 chunk 的操作（包括 balance、split、move）都会跳过或失败——必须用 sh.removeJumbo("db.collection") 显式清除标记，且确保此时 chunk 已实际可分割。
