AbortController 完全指南：Node.js 的取消机制
AbortController 为异步操作提供标准取消信号：fetch 超时、流取消、多信号合并。本文讲解核心 API、AbortSignal.timeout/any 与 Node 核心 API 支持。
const c = new AbortController(); fetch(url, { signal: c.signal })，调 c.abort() 取消请求。一行超时：AbortSignal.timeout(5000)。多信号合并：AbortSignal.any([s1, s2])。它结束了 Node 异步操作"发起即不可取消"的时代。
为什么需要取消机制
没有取消的异步操作：请求发出后用户离开了页面——响应回来无人接收，资源空耗；批量处理中途失败——剩余任务继续空跑。AbortController 提供标准的"停止信号"语义。
基础用法
const controller = new AbortController();
const promise = fetch('/api/data', { signal: controller.signal });
controller.abort(); // 取消——fetch 以 AbortError 拒绝
try {
await promise;
} catch (err) {
if (err.name === 'AbortError') console.log('已取消'); // 取消不是失败
}
一行超时
// 5 秒自动取消——最常见的超时需求
fetch(url, { signal: AbortSignal.timeout(5000) });
多信号合并
// 用户取消 或 超时 或 服务关停——任一触发即取消
const signal = AbortSignal.any([
userSignal,
AbortSignal.timeout(5000),
server.shutdownSignal,
]);
fetch(url, { signal });
AbortSignal.any 让"取消原因的 OR 组合"成为声明式——优雅关停实现的关键件。
流传输与 Node 核心 API
Node 核心 API 广泛接受 signal：fs.readFile、http.request、流管道、setTimeout/promises……检查 API 文档的 signal 选项——长操作都应可取消。
await pipeline(readable, transform, writable, { signal });
取消的正确处理
- AbortError 是"正常路径"——不计入错误指标；
- 取消后清理：定时器 clearTimeout、监听器移除、连接关闭；
- 取消传播：组合操作把 signal 透传给所有子操作。
常见问题（FAQ）
Q：取消后操作真的停止了吗？
signal 是"请求取消"——协作式取消：被调方负责检查信号并终止。fetch/Node API 都正确实现了协作；自己的长循环要 signal.throwIfAborted() 周期检查。
Q：能取消 Promise 吗？
Promise 本身不可取消——AbortController 是给"操作"发信号。包装设计良好的异步函数接受 signal 参数。
Q：服务端怎么传播取消？
请求的 aborted 事件接到后，取消该请求触发的下游调用（数据库查询、外部 API）——全链路取消才是资源真正释放。
参考文档
本文依据公开文档整理，示例需按项目依赖版本验证；不将文档中的性能描述视为本项目实测结果。
