GridFSBucket下载大文件时需三层背压协同：设openDownloadStream的start/end范围、pipeline显式配置highWaterMark（如64KB）、下游写入必须支持drain事件并监听error/close手动destroy流，否则MongoDB cursor滞留致内存暴涨。
Node.js 中用 GridFSBucket 下载文件时，不加背压控制极易导致内存暴涨甚至 OOM —— 因为 openDownloadStream() 返回的是可读流，而下游写入（如 res、fs.createWriteStream）若慢于读取，数据会在内存中堆积，pipeline 本身不自动限速，必须显式配合 highWaterMark 或中间节流流。
为什么 stream.pipeline 不能直接解决 GridFS 背压？
pipeline 确实会传递 backpressure 信号（比如下游 write() 返回 false 时暂停上游 read()），但它依赖各环节正确实现流协议。而 GridFSBucket.openDownloadStream() 返回的流底层基于 MongoDB 驱动的 cursor + chunk 拼接，其内部缓冲行为不受 pipeline 的 highWaterMark 直接约束；尤其当网络延迟高、MongoDB 响应快时，驱动可能预取多个 fs.chunks 文档进内存，造成“假背压失效”。
常见错误现象：
– 小文件正常，大文件（>100MB）下载时 Node 进程 RSS 内存飙升至 1GB+
– process.memoryUsage().heapUsed 持续上涨，GC 频繁但无法释放
– 日志里出现 MaxListenersExceededWarning（因未及时销毁流）
如何用 pipeline + 参数调优真正控住背压
核心是三层协同：限制读取节奏、约束管道缓冲、确保流终结。不要只改一个地方。
-
openDownloadStream()的options中设start/end做范围读（避免全量加载），或搭配readPreference降低主节点压力 - 给
pipeline显式传{ highWaterMark: 64 * 1024 }（64KB），这是管道内部 buffer 上限，不是单次read()大小 - 下游写入目标必须支持
write()返回布尔值（如原生fs.WriteStream、http.ServerResponse），且不能忽略drain事件 - 务必监听
pipeline的error和close，并在出错时手动downloadStream.destroy()，否则 MongoDB cursor 会滞留
示例片段：
const { pipeline } = require('stream');
const { promisify } = require('util');
const { GridFSBucket } = require('mongodb');
<p>const pipelineAsync = promisify(pipeline);</p><p>async function downloadFile(res, bucket, fileId) {
const downloadStream = bucket.openDownloadStream(fileId, {
// 控制初始读取范围，减少首屏等待和内存占用
start: 0,
end: 10 <em> 1024 </em> 1024 // 可选：按需分片
});</p><p>try {
await pipelineAsync(
downloadStream,
res, // http.ServerResponse 自带背压支持
{ highWaterMark: 64 * 1024 } // 关键：限制 pipeline 内部缓冲
);
} catch (err) {
downloadStream.destroy(); // 必须！防止 cursor 泄漏
throw err;
}
}什么时候该加节流流（throttling Transform）而不是只靠 pipeline
当业务明确要求出口带宽上限（比如限速 2MB/s 给公网用户），或下游是慢设备（如串口、低配 NAS），仅靠 highWaterMark 和自然背压不够稳定——因为 MongoDB 驱动可能批量拉取 chunk，导致瞬时 burst。
此时应插入一个可控节流流：
- 用
stream.Transform包一层，每次push()前await delay(ms)（同步节流慎用，会阻塞事件循环） - 更推荐
through2+sleep-promise实现异步节流，避免阻塞 - 节流逻辑必须放在
pipeline中间，且transform的highWaterMark要设小（如16 * 1024），否则节流前已积压 - 注意：节流后
Content-Length无法提前知道，res需设transfer-encoding: chunked（HTTP/1.1 默认）
容易被忽略的清理细节
GridFS 流不像普通文件流，它的生命周期绑定 MongoDB cursor。以下三点不处理，跑几天就会触发 idleCursorTimeoutMillis 警告甚至连接池耗尽：
-
downloadStream必须在pipeline结束后显式.destroy()，不能只靠pipeline自动关闭（某些 error 场景下不会触发） - 如果用了
start/end，要确保end值不超过文件实际长度，否则downloadStream会卡在等待不存在的 chunk - 在 Express/Koa 中，
res.on('close', () => downloadStream.destroy())是必须的，用户中途关网页也要释放 cursor
最危险的坑：把 downloadStream 当普通流传给多个 pipeline 复用 —— 它是一次性流，重用会报 Stream is not readable 或静默失败。
