mongoose 不提供 createdownloadstream 方法，因其仅抽象集合级 crud，gridfs 操作需用原生 mongodb 驱动的 gridfsbucket；正确流程是先通过 bucket.findone() 查询元数据，再用 opendownloadstream(doc._id) 开流，并手动设置响应头。
不能直接用 Mongoose 流式读取 GridFS 文件——Mongoose 本身不封装 GridFS 操作，必须用原生 MongoDB 驱动的 GridFSBucket。 所有试图在 Mongoose Model 上调用 createDownloadStream 或类似方法的行为，都会失败或返回空流。
为什么 Mongoose 没有 createDownloadStream 方法
Mongoose 是 ODM（对象文档映射），它抽象的是集合（Collection）级别的 CRUD，不是文件系统层。GridFS 是 MongoDB 底层的文件存储规范，由 mongodb 官方驱动原生支持，Mongoose 不做桥接、也不暴露 GridFSBucket 实例。
- 你引入的是
mongoose，但实际要操作 GridFS，必须从mongodb包里拿GridFSBucket -
mongoose.connection.db可以拿到原生Db实例，再传给new GridFSBucket(db) - 别指望
Model.findOne().createDownloadStream()—— 这个链式调用根本不存在，会报TypeError: ... is not a function
如何正确获取 GridFS 下载流（v5+ 驱动）
必须跳过 Mongoose，用原生驱动走两步：先查元数据文档，再用 _id 开流。漏掉任一环节，流就为空或抛错。
- 用
bucket.find({ filename: "report.pdf" }).toArray()或更稳妥的bucket.findOne({ filename: "report.pdf" }) - 检查返回值是否为真：
if (!doc) throw new Error("file not found")，否则doc._id是undefined - 调用
bucket.openDownloadStream(doc._id)—— 注意是openDownloadStream，createDownloadStream已废弃 - 手动设置响应头：
res.setHeader("Content-Type", doc.contentType || "application/octet-stream")，res.setHeader("Content-Disposition", `attachment; filename="${doc.filename}"`)
常见错误现象和修复点
流没数据、立刻结束、或报 GridFSBucketReadStream is not a constructor，基本都卡在这几个地方：
- 传了字符串
"report.pdf"给openDownloadStream()—— 它只认ObjectId或Buffer类型的_id - 用的是 v5+ 驱动，却照着 v3 文档写
bucket.createDownloadStream({ filename: "x" })—— 新版不支持该签名 - 文件名含空格或中文，但存储时没做精确匹配（MongoDB 默认区分大小写、不 trim）—— 建议查
{ filename: { $eq: "data.json" } }而非模糊匹配 - 没 await
findOne()就直接用返回值，导致doc是 Promise，doc._id是undefined
真正麻烦的不是代码长度，而是混合使用 Mongoose 和原生驱动时的上下文切换：连接复用要小心，mongoose.connection.db 必须确保已 ready，且不能在未 connect 时就初始化 GridFSBucket。这点容易被忽略，一启动就报 db is not open。
