Node.js服务中客户端取消请求时如何终止后续执行流程

很多开发者写完接口只会把所有异步任务按顺序await等待，全程不感知客户端连接状态——哪怕用户早就关闭了浏览器标签页，服务器还是会把爬链接、截图、生成PDF的全流程跑完，白白消耗CPU、内存和磁盘资源。要实现客户端任意断连都能中止关联流程，不需要引入复杂的任务队列，用Node.js原生能力就能低成本落地。

Express框架下的请求对象req，本身就会在客户端主动断开连接时触发对应事件（兼容不同版本的close、aborted事件），但仅监听事件不做流程拦截是没有意义的：如果十几秒的截图流程跑完了才感知到客户端断连，之前的资源消耗已经产生了。
正确的做法是用Node.js原生的AbortController作为贯穿全流程的取消令牌，让每一步长耗时操作都能实时感知取消状态，一旦收到取消信号就立刻终止执行、清理占用资源。

app.get("/api/processScreenshot/:url", async (req, resp) => {
  // 初始化原生取消控制器
  const abortController = new AbortController();
  const abortSignal = abortController.signal;

  // 定义断连触发的取消处理函数
  const triggerAbort = () => {
    // 仅当响应还没正常完成发送时，才触发取消，避免误杀正常流程
    if (!resp.writableEnded) {
      abortController.abort(new Error("客户端已取消请求"));
    }
  };
  // 绑定客户端断连的两类兼容事件
  req.on("close", triggerAbort);
  req.on("aborted", triggerAbort);

  try {
    // 把取消信号传入每一步长耗时任务，供任务内部实时检查状态
    const links = await collectAllLinks(url, abortSignal);
    // 每一步执行完先校验取消状态，避免执行后续无效操作
    if (abortSignal.aborted) throw abortSignal.reason;

    const screenshotsPath = await takeScreenshots(links, abortSignal);
    if (abortSignal.aborted) throw abortSignal.reason;

    const pdfPath = await createPDF(screenshotsPath, abortSignal);
    if (abortSignal.aborted) throw abortSignal.reason;

    // 全流程无异常、无取消，才返回最终结果
    resp.status(200).end(pdfPath);
  } catch (err) {
    // 捕获到取消触发的错误时，直接清理资源，不需要给已断连的客户端发响应
    if (abortSignal.aborted) {
      // 在此处补充资源清理逻辑：删除临时截图文件、销毁未完成的PDF实例、关闭残留的puppeteer浏览器/页面进程
      return;
    }
    // 非取消类的业务错误，正常返回给客户端
    resp.status(500).end("服务处理失败");
  } finally {
    // 流程结束（无论正常完成/异常取消）都解绑事件监听，避免内存泄漏
    req.off("close", triggerAbort);
    req.off("aborted", triggerAbort);
  }
});

• 不要等到流程最后一步才判断取消状态：长流程的资源消耗核心在cheerio爬取链接、puppeteer截图、pdfkit生成这几个环节，必须在每个小执行节点（比如爬完一个链接、截完一张图、写完一页PDF）就检查一次取消状态，真正做到中途随时停止
• 必须增加resp.writableEnded状态判断：正常返回响应后连接关闭也会触发close事件，不加判断会把正常完成的请求误判为客户端取消，额外触发无意义的资源清理
• 针对第三方组件做定向资源回收：
  • puppeteer环节触发取消时，要手动关闭已打开的页面、退出挂载的无头浏览器进程，避免残留进程长期占用内存
  • pdfkit环节触发取消时，要手动销毁PDF写入流，删除临时目录里的残次文件，避免磁盘空间被无效文件占用
• 取消触发后不要尝试给客户端发送响应：客户端已经主动断连，发送响应属于无效网络传输，不如直接释放算力处理其他正常请求

内容的提问来源于stack exchange，提问作者Raghu Chahar