Express路由超时终止回调执行 解决ERR_HTTP_HEADERS_SENT错误

res.setTimeout仅负责监听底层Socket连接的超时事件，触发回调时既不会自动中断路由内正在执行的业务逻辑，也不会拦截后续的响应操作，这就是触发ERR_HTTP_HEADERS_SENT报错、同时产生无效资源消耗的根本原因。另外受JS单线程作用域规则限制，超时回调内的return确实无法终止外层路由函数的执行，这个判断是准确的。

方案1：使用专用超时中间件（推荐） #

Express生态下的标准超时处理是通过专用中间件实现，相比手写res.setTimeout逻辑更严谨，能和Express本身的错误处理链路打通，避免重复响应问题。
示例实现：

const timeout = require('connect-timeout');

// 针对当前路由组配置10秒超时，关闭中间件默认的响应逻辑，走自定义返回
router.use(timeout('10s', { respond: false }));

// 统一错误处理中间件，捕获超时错误返回自定义JSON格式
router.use((err, req, res, next) => {
  if (req.timedout && err.message === 'Response timeout') {
    return res.status(500).json({ error: 'Response Processing Timed Out.' });
  }
  next(err);
});

// 业务路由
router.get('/', async (req, res, next) => {
  try {
    let result = 0;
    // 耗时代码执行过程中，在可中断的节点主动判断超时状态
    for (let i = 0; i < 100; i++) {
      // 一旦检测到超时直接抛错终止执行，避免无意义的资源消耗
      if (req.timedout) throw new Error('task aborted');
      // 执行耗时操作：数据库查询、计算、IO请求等
      result += await heavyWorkStep(i);
    }
    // 发送响应前做兜底判断，彻底避免重复发送响应头
    if (!res.headersSent) res.json(result);
  } catch (err) {
    // 超时触发的中断不需要重复处理响应，直接返回即可
    if (req.timedout) return;
    next(err);
  }
});

注意：Node.js单线程模型下没有手段能无侵入强行终止正在运行的同步代码，所有超时中断逻辑都需要业务代码在执行节点主动判断超时标记，这是Node.js服务端开发的通用规则，不是Express的设计缺陷。如果是CPU密集型的长耗时同步任务，建议放到worker_threads中执行，才能实现真正的及时中断。

方案2：基于原生AbortController实现（无额外依赖） #

如果不想引入第三方包，可以用Node.js原生的AbortController实现可控的超时逻辑，核心逻辑和超时中间件一致：

router.get('/', (req, res, next) => {
  const ac = new AbortController();
  const { signal } = ac;

  // 启动超时定时器
  const timeoutTimer = setTimeout(() => {
    ac.abort(); // 发出中断信号
    if (!res.headersSent) {
      res.status(500).json({ error: 'Response Processing Timed Out.' });
    }
  }, 10000);

  // 执行业务逻辑，传入signal支持中断
  runTimeConsumingTask(signal)
    .then(result => {
      clearTimeout(timeoutTimer);
      if (!res.headersSent) res.json(result);
    })
    .catch(err => {
      clearTimeout(timeoutTimer);
      // 超时触发的中断无需重复处理响应
      if (err.name === 'AbortError') return;
      next(err);
    });
});

// 耗时任务示例
async function runTimeConsumingTask(signal) {
  let count = 0;
  for (let i = 0; i < 1000; i++) {
    if (signal.aborted) throw new Error('AbortError');
    // 目前绝大多数Node.js生态的IO驱动（数据库、HTTP客户端等）都原生支持传入signal参数，会自动取消未完成的请求
    count += await computeStep(i);
  }
  return count;
}

• 所有调用res.json、res.send等响应方法的位置，都可以加!res.headersSent判断做兜底，100%避免ERR_HTTP_HEADERS_SENT报错，不管是超时还是其他分支的提前响应都能覆盖。
• 不要在主事件循环里跑超过100ms的同步CPU密集任务，这种场景下就算超时触发了，回调也要等同步代码跑完才能执行，根本达不到超时中断的效果。
• 如果你升级到Express 5.x版本，路由原生支持Promise异步捕获，超时抛错后的处理逻辑会更简洁，不需要手动写catch传递错误。

内容的提问来源于stack exchange，提问作者Faik Djikic