MD5字段在MongoDB 5.0+中已弃用，PyMongo 3.12+仅支持在GridFSBucket初始化时通过disable_md5=True关闭，upload_from_stream等上传方法中传参无效。
md5 字段在 MongoDB 5.0+ 中已弃用，不是“不显示”，而是驱动不再写入、服务端也不再校验——你查 files 集合会发现字段直接为空或根本不存在，这不是 bug，是明确的废弃行为。
PyMongo 3.12+ 关闭 MD5 的唯一生效位置是 GridFSBucket 初始化
很多人试过在 upload_from_stream() 里传 options={'disable_md5': True}，结果毫无作用。这是因为 PyMongo 的 MD5 计算逻辑绑定在桶实例生命周期内，上传时参数不接管哈希开关。
必须这样初始化：
from pymongo import MongoClient from gridfs import GridFSBucket <p>client = MongoClient() db = client.mydb bucket = GridFSBucket(db, disable_md5=True) # ✅ 唯一有效位置</p>
-
disable_md5=True只影响后续新上传，已有文件的md5字段仍保留（也不会被删） - 旧版 PyMongo（TypeError
- 如果项目混用多个 bucket 实例，每个都要显式传参，不能全局配置
Node.js 驱动 4.13+ 才有 disableMD5 选项
官方 mongodb driver 在 4.13 版本前（包括所有 3.x 和 4.0–4.12）完全没暴露这个控制权。你找不到任何配置项，也无从绕过——哈希强制执行，无法禁用。
升级到 4.13+ 后，可这样写：
const { GridFSBucket } = require('mongodb');
const bucket = new GridFSBucket(db, { disableMD5: true });
- 注意键名是
disableMD5（驼峰），不是disable_md5 - 同样只对新建 bucket 生效，不影响历史文件
- 若无法升级驱动，只能改架构：把小文件转存为
BinData存进普通文档，绕开 GridFS
为什么 MongoDB 要废弃 md5 字段
不是为了“省点 CPU”，而是因为 MD5 已不具备实用校验价值：
- MD5 碰撞已被实证，无法防御恶意篡改
- GridFS 分块存储本身不保证块间顺序完整性，单算整个文件哈希无意义
- 真正需要端到端校验的场景，应由业务层在上传/下载前后自行计算 SHA-256 或更安全摘要
- 集群中大量客户端并发算 MD5，反而成了性能瓶颈，尤其 Node.js 这类单线程环境
替代方案：用 SHA-256 自行存入 metadata
如果你确实需要文件完整性验证，别依赖废弃字段。把摘要算好后塞进 metadata 是最可控的做法：
import hashlib
with open('file.bin', 'rb') as f:
sha256 = hashlib.sha256(f.read()).hexdigest()
<p>bucket.upload_from_stream(
'file.bin',
file_stream,
metadata={'sha256': sha256} # ✅ 自定义字段，长期可用
)</p>
- 下载后重新计算比对，逻辑完全由你掌控
- 支持并行分片校验（比如按 chunk 算 SHA-256 再 Merkle 树聚合）
- 避免和驱动内部哈希逻辑耦合，升级驱动不踩坑
实际部署时最容易忽略的一点：disable_md5=True 必须出现在所有 GridFSBucket 实例化位置，包括测试、迁移、后台任务脚本——漏一个，CPU 就可能突然拉满。
