MongoDB 6.0+禁止对fs.chunks单独分片,因其与fs.files强绑定且仅支持_id哈希分片;正确做法是只对fs.files执行sh.shardCollection("db.fs.files", {"_id": "hashed"}),chunks自动跟随路由。

不能对 fs.chunks 集合单独执行 sh.shardCollection ——MongoDB 6.0+ 明确禁止,任何尝试都会报错:cannot shard collection with non-_id shard key on a GridFS namespace。
为什么 fs.chunks 无法手动分片
GridFS 的 fs.files 和 fs.chunks 是强绑定的逻辑对,MongoDB 内部通过 _id(即 fs.files._id)与 fs.chunks.files_id 做原子级关联。为保证读写一致性,从 MongoDB 4.4 开始强化校验,到 6.0+ 已彻底锁死规则:
- 只允许对
fs.files执行sh.shardCollection("db.fs.files", {"_id": "hashed"}) -
fs.chunks不接受任何分片命令;即使你绕过校验强行写入分片配置,mongos 也会拒绝路由或直接报错 - 所谓“用
{files_id: 1}分片 chunks”的做法,仅存在于 ≤3.2 版本且未启用命名空间校验的遗留部署,当前环境完全失效
正确分片路径:只动 fs.files,fs.chunks 自动跟随
只要对 fs.files 成功启用哈希分片,fs.chunks 就会按 files_id 自动路由到对应分片——这是 MongoDB 内置行为,无需干预:
- 执行顺序必须是:
sh.enableSharding("mydb")→sh.shardCollection("mydb.fs.files", {"_id": "hashed"}) - 分片后所有新写入的文件,其
_id(默认 ObjectId)经哈希后均匀分布,对应 chunk 也自然落在同一分片 - 已有数据无法补分片——GridFS 不支持后期修改分片键,必须导出重建
fs.files和fs.chunks - 确保客户端生成的
_id具备散列性;若业务自定义_id(如时间戳字符串),需先哈希再赋值,否则仍会写入热点
常见性能问题其实和 fs.chunks 分片无关
如果你观察到查询慢、跨分片扫描多、chunk 分布不均,大概率不是 fs.chunks 没分片,而是以下三点没对齐:
- 没给高频查询字段建索引:例如按
filename查文件,必须手动建db.fs.files.createIndex({"filename": 1}),否则 mongos 会广播到所有分片 -
chunkSize设置失当:默认 256KB 在混杂文件场景易引发 chunk 数量爆炸;建议统一设为1024(1MB),减少元数据压力 - 误以为能靠分片键优化查询:分片键已锁定为
_id: "hashed",无法改成filename或user_id;所有非_id查询都依赖二级索引 + 路由策略
真正容易被忽略的是:分片生效的前提是「所有写入都走 GridFS 驱动的标准 API」。如果跳过驱动、直写 fs.chunks 文档,或手动插入 fs.files 但没填全字段(如漏掉 length 或 chunkSize),mongos 就无法正确识别文件结构,后续读取会失败或返回空内容。











