Node.js Express HTTP服务中如何等待/download文件传输完成后返回错误列表?
跨路由实现传输完成等待的实现方案
原代码存在三个天然的逻辑缺陷,是导致无法实现需求的核心原因:
- 收集错误的
errorList是/download路由内的函数局部变量,路由请求执行完成后,这个变量所在的函数上下文就会被销毁,其他路由根本无法访问到 - 没有维护统一的传输状态标记,无法区分当前流程是未开始、传输中、已完成三个阶段,
/geterrors根本没法判断当前是直接返回还是需要等待 - 没有机制在传输全流程结束时主动通知等待方,硬做同步等待会直接阻塞整个Express的事件循环,导致服务完全不可用
实现步骤
1. 定义模块级的共享传输状态
把需要跨路由共享的状态提到模块顶层,不能放在路由函数内部。状态结构需要包含当前传输的阶段标记、错误收集列表、以及用来唤醒等待请求的回调引用:
// 模块级全局共享状态(单进程部署下可直接使用) const transferState = { status: 'idle', // 可选值:idle(无传输)/ transferring(传输中)/ completed(传输已结束) errors: [], // 收集全流程的错误 waitResolver: null // 存储挂起请求的Promise resolve方法 }
2. 改造 /download 路由的生命周期同步逻辑
在文件传输流程的各个关键节点同步更新全局状态,传输流程彻底收尾(不管成功还是出错)时,主动唤醒所有挂起的错误查询请求:
app.get('/download', async (req, res) => { // 新的下载流程启动时,重置上一轮的状态 transferState.status = 'transferring' transferState.errors = [] const fileStream = someWayToPipeTheFile(res, filename) // 收集文件流触发的错误 fileStream.on('error', (error) => { transferState.errors.push(error) }) // 传输流程结束(成功/失败)时统一收尾 fileStream.on('end', () => { transferState.status = 'completed' reportThatFileWasSent() // 唤醒所有挂起的/geterrors请求,传入收集到的错误列表 if (transferState.waitResolver) { transferState.waitResolver(transferState.errors) transferState.waitResolver = null } }) // 额外监听客户端主动断开的场景,这类错误也要纳入收集范围 res.on('close', () => { if (!res.headersSent) return transferState.errors.push(new Error('Client disconnected mid-transfer')) }) })
3. 改造 /geterrors 路由的异步等待逻辑
不要用同步阻塞的方式等待传输完成,基于当前传输状态做分支判断,对未完成的传输用Promise把请求挂起,等传输结束的触发信号再返回响应:
app.get('/geterrors', (req, res) => { // 传输已经彻底完成,直接返回收集到的错误列表 if (transferState.status === 'completed') { return res.send(transferState.errors) } // 当前没有正在进行的传输,直接返回空列表 if (transferState.status === 'idle') { return res.send([]) } // 传输还在进行中,挂起当前请求,等传输结束的通知 new Promise((resolve) => { // 把当前请求的resolve方法存到全局状态,等待传输流程触发唤醒 transferState.waitResolver = resolve }).then((errorList) => { res.send(errorList) }) })
落地注意事项
- 上述方案仅适用于单进程单实例的Express服务,如果是多实例部署、前置了负载均衡,本地内存的状态是跨进程不共享的,需要把状态迁移到Redis这类外部存储,配合发布/订阅机制实现跨进程的事件通知
- 挂起的请求必须加超时兜底,避免因为文件流异常、事件未触发等极端情况导致请求永久挂起,比如给等待逻辑加10秒超时,到点后直接返回当前已经收集到的错误列表
- 并发场景下要给每次下载请求加唯一标识,避免多个并发下载流程的错误被混到同一个状态里
- 禁止用路由内的局部变量做跨请求的共享存储,每次Express路由被请求时都会生成独立的req/res上下文,局部变量在请求结束后就会被垃圾回收,无法被其他路由访问
内容的提问来源于stack exchange,提问作者Demiler
相关产品推荐
相关产品推荐

