gridfs 在分片集群中需手动分片 fs.files 和 fs.chunks 集合，且必须在写入数据前完成；fs.chunks 必须以 files_id 为哈希分片键以保证同文件 chunk 同片，避免跨分片查询性能下降。
GridFS 本身不直接支持跨分片集群的“自动分片”，但通过手动配置 fs.files 和 fs.chunks 集合的分片策略，可以实现大文件在分片集群中的分布式存储——前提是分片键选得对、集合启得早、权限配得准。
GridFS 分片必须提前启用，不能事后 sharding
MongoDB 的 GridFS 是两个逻辑集合：fs.files（元数据）和 fs.chunks（二进制块）。它们默认是普通集合，**不会自动参与分片**。一旦数据写入，再执行 sh.shardCollection() 会失败或导致数据不均衡。
- 必须在写入任何文件前，用
sh.shardCollection("mydb.fs.files", { _id: "hashed" })和sh.shardCollection("mydb.fs.chunks", { files_id: "hashed" })显式分片 -
fs.chunks的分片键必须是files_id（不是_id），否则 chunk 无法按文件聚合，查询时会跨多个分片拉取，性能断崖式下降 - 如果已存在数据，需先导出
fs.files/fs.chunks→ 清空 → 分片 → 重新导入，否则shardCollection报错Cannot shard collection with existing data unless it has a shard key index
为什么推荐 { files_id: "hashed" } 而不是 { _id: "hashed" }
因为 fs.chunks.files_id 是外键，指向 fs.files._id。用 files_id 哈希能保证同一文件的所有 chunk 落在同一个分片上（co-location），避免跨分片 JOIN 查询；而用 _id 哈希会导致一个文件的 chunk 散落在不同分片，读取时需合并多次网络请求，延迟翻倍。
-
fs.files可用{ _id: "hashed" }或{ filename: "hashed" }，但后者不利于按名称范围查询，一般选前者 - 若业务常按
filename或自定义元字段（如user_id）查询，可在fs.files上建额外索引，但分片键仍应保持为_id或哈希字段 - 注意：MongoDB 5.0+ 支持对
fs.files使用非_id字段分片（如{ "metadata.user_id": 1 }），但要求该字段写入时必填且稳定，否则易产生空值分片倾斜
常见报错与绕过方式
运行 sh.shardCollection 时最常遇到三个错误：
-
collection already exists：说明集合已存在但未分片。先确认是否已有数据，有则清空再分片；无数据可加numInitialChunks参数加速预拆分 -
shard key not found in document：写入fs.files时漏传_id（比如用驱动默认 ObjectId 生成但没显式指定），或写fs.chunks时files_id字段缺失/类型错误（必须是 ObjectId 或字符串 ID） -
not master或not connected to a mongos：当前连接的是单个mongod而非mongos路由进程。务必用mongo --host localhost:27017连mongos端口（如 27018），而非分片节点端口
分片后 GridFS 的实际行为变化
启用分片后，mongofiles、驱动 API（如 GridFSBucket）和 mongo-express 的 GridFS 功能基本不受影响——它们仍走标准协议，但底层数据已分布到多个分片。真正要注意的是：
- 文件上传/下载吞吐量提升，但单次小文件操作延迟略增（因路由转发开销）
-
db.fs.files.countDocuments()变成广播查询，响应时间变长；建议用collStats查分片级统计 - 备份必须通过
mongodump --uri="mongodb://mongos-host:27018"连mongos，直连某个分片只会导出局部数据 - 删除整个文件（
deleteId）仍是原子操作，但依赖两阶段提交，若某分片临时不可达，可能残留孤立 chunk，需定期运行db.runCommand({ cleanupOrphaned: "mydb.fs.chunks" })
分片键设计是 GridFS 跨集群落地的唯一门槛，其他都是常规运维动作。一旦 files_id 哈希分片跑通，后续扩容分片节点、调整 chunk size、甚至切换为 zone-based 分片，都不需要改应用代码。
