GridFS损坏主因是绕过Bucket API直操作fs.chunks,应严格使用openDownloadStream触发自动校验(含MD5、序号、长度检查);上传须设disableMD5: false;修复需用bucket.delete清理孤儿文档,禁止单独删集合。

用 GridFSBucket.openDownloadStream 触发自动校验,别自己拼 chunks
文件损坏最常见原因是绕过 GridFS 抽象层、直接查 fs.chunks 拼接数据。这种写法跳过了所有校验逻辑:chunk 缺失不报错、n 序号错乱不修复、MD5 不比对、甚至把不同文件的 chunk 混在一起。驱动只认 GridFSBucket.openDownloadStream 这一个入口——它会在流初始化时读取 fs.files 元数据,再按 files_id + n 顺序拉取 fs.chunks,每块都校验长度和 MD5(如果元数据里存了)。一旦某块缺失或哈希不匹配,会直接抛出错误,而不是静默返回损坏数据。
检查 fs.files.md5 是否为空或不一致
md5 字段是 GridFS 文件完整性最轻量的兜底手段,但很多人上传时没开它。确认方式很简单:
- 上传时显式启用:
bucket.openUploadStream(filename, { disableMD5: false })(Go 驱动默认开启;Node.js v6+ 驱动需手动设) - 查现有文件:
db.fs.files.findOne({ _id: ObjectId("...") }, { projection: { md5: 1 } }),若字段不存在或为null,说明该文件无校验基础 - 修复动作:重新上传该文件,并确保
disableMD5: false;不要试图手动补md5字段——它必须由驱动在上传时计算,否则无效
用 db.fs.chunks.find() 定位缺失 chunk 的 files_id
当 openDownloadStream 报错类似 "chunk not found for files_id: ..., n: 5",说明 fs.chunks 里缺了第 5 块。这时不能只删元数据了事,得先定位问题范围:
- 查所有疑似损坏的文件:
db.fs.files.aggregate([ { $lookup: { from: "fs.chunks", localField: "_id", foreignField: "files_id", as: "chunks" } }, { $addFields: { expectedCount: { $ceil: { $divide: ["$length", "$chunkSize"] } } } }, { $project: { filename: 1, length: 1, chunkSize: 1, expectedCount: 1, actualCount: { $size: "$chunks" } } }, { $match: { "expectedCount": { $ne: "$actualCount" } } } ]) - 结果里
expectedCount > actualCount的文件,就是 chunk 缺失的候选;记下它们的_id,后续用bucket.delete()彻底清理 - 注意:不要用
db.fs.chunks.deleteMany({ files_id: ... })单独删块——这会导致fs.files元数据残留,变成孤儿文档
删除并重传前,确认 fs.files 无孤儿文档
真正难缠的损坏常来自“半删除”:业务代码只删了 fs.chunks 或只删了业务表引用,却漏掉调用 bucket.delete(fileId)。这些残留的 fs.files 文档会持续膨胀,且下次同名上传时可能被误认为旧版本。清理步骤必须严格:
- 找出孤儿元数据:
db.fs.files.aggregate([ { $lookup: { from: "fs.chunks", localField: "_id", foreignField: "files_id", as: "chunks" } }, { $match: { "chunks.0": { $exists: false } } }, { $project: { _id: 1, filename: 1, uploadDate: 1 } } ]) - 逐个执行
bucket.delete(orphanId)—— 这才是唯一能安全清理fs.files+fs.chunks关联数据的操作 - 切忌用
db.fs.files.remove(...)直接删文档,否则fs.chunks里的块永远留着,持续占用空间并干扰索引统计
最关键的细节是:GridFS 的损坏几乎从不源于单次上传失败,而是长期混用底层集合操作与高层 Bucket API 所致。修复动作本身很简单,但前提是彻底切断“手写 chunks 查询”的路径——哪怕只是为了调试,也该用 openDownloadStream 的 error 信息反推问题,而不是跳进集合里手动修补。











