Node.js 中如何使用 AbortController 正确取消未完成的异步 HTTP 请求？

在 Node.js 中，实例化 AbortController 并将 controller.signal 传给支持该信号的 HTTP 客户端（如 fetch 或 axios），调用 controller.abort() 即可取消请求。适用于超时控制或用户中断场景，风险在于部分原生模块需 Node.js v16 以上版本才稳定支持，且 v18 之前全局 fetch 不可用。

先说结论：AbortController 是标准 API，配合支持 signal 的客户端可安全取消请求，但需注意 Node.js 版本兼容性和客户端库支持情况。

适合：需要手动中断耗时请求、实现请求超时逻辑或取消竞态请求的场景。
先看：确认 Node.js 版本是否支持全局 AbortController（v16+ 稳定），以及 HTTP 客户端是否接收 signal 参数。
建议：捕获 AbortError 异常以避免未处理的 Promise rejection，并在 finally 块中清理资源。

快速处理思路

若使用 Node.js v18+ 全局 fetch 或 axios 库，可直接传入 signal 对象。以下是基于全局 fetch 的最小可用代码：

const controller = new AbortController();
const { signal } = controller;

fetch('https://example.com', { signal })
  .then(res => res.json())
  .catch(err => {
    if (err.name === 'AbortError') {
      console.log('请求已取消');
    } else {
      throw err;
    }
  });

// 需要取消时调用
controller.abort();

为什么会这样

AbortController 通过 signal 对象在控制器和请求之间建立监听关系。调用 abort() 方法会触发 signal 的 abort 事件，请求客户端监听该事件后终止底层网络连接并抛出特定错误。

这种机制将取消逻辑从请求内部解耦，允许外部代码（如定时器、用户操作）控制请求生命周期。Node.js 底层基于 libuv 实现异步 IO，abort 信号会通知底层 socket 关闭，从而释放资源。

分步处理

1. 实例化控制器：在请求作用域内创建 new AbortController()，避免全局复用导致信号混乱。

2. 传递 signal：将 controller.signal 作为配置项传给 fetch、axios 或支持的 http 请求函数。

Node.js 中如何使用 AbortController 正确取消未完成的异步 HTTP 请求？

3. 监听取消：在 catch 块中判断 err.name === 'AbortError'，区分正常错误和取消操作。

4. 触发取消：在满足条件（如超时定时器触发、组件卸载）时调用 controller.abort()。

怎么验证是否生效

查看控制台日志是否输出"请求已取消"，确认未进入后续业务逻辑。使用网络监控工具观察 TCP 连接是否提前关闭。检查进程内存占用，确认未完成的请求对象已被垃圾回收。

常见坑

1. 版本兼容性：Node.js v15.4.0 引入但为实验性，v16.0.0 才稳定，v18.0.0 才支持全局 fetch。旧版本需引入 node-fetch 或 polyfill。

2. 原生 http 模块：Node.js 原生 http/https 模块不直接支持 AbortController signal，需手动销毁 socket 或使用第三方封装库。

3. 服务端状态：客户端取消请求不会自动回滚服务端已执行的事务，需在服务端设计幂等性或补偿机制。

常见问题

Node.js 哪个版本开始稳定支持 AbortController？

Node.js v16.0.0 开始稳定支持全局 AbortController，v15.4.0 为实验性版本。

axios 在 Node.js 中如何使用 AbortController？

axios 支持传入 signal 参数，用法与 fetch 类似，将 controller.signal 放入 axios 配置对象即可。

取消请求后为什么还会收到响应？

取消信号发出后，若数据已在传输途中或服务端已处理完成，客户端仍可能接收部分数据，但后续处理会被中断。

参考来源

Node.js Documentation: AbortController (https://nodejs.org/api/abort_controller.html)

MDN Web Docs: AbortController (https://developer.mozilla.org/en-US/docs/Web/API/AbortController)