Express.js 请求超时时主动终止请求的可行实现方案咨询

方案不生效的核心原因 #

• 超时中间件放置位置错误：如果你的超时中间件放在了express.json、multer这类请求体解析中间件之后，慢连接上传的场景下，请求体完全接收完成后才会走到超时逻辑，自然不会触发回调。
• 超时回调未销毁底层连接：当你自定义req.setTimeout的回调函数时，Node.js不会自动销毁套接字，请求会继续在后台处理，表现为回调从未触发。

请求层面超时的正确实现 #

修正后的代码如下，注意超时中间件必须放在所有其他中间件的最顶层：

const express = require('express');
const server = express();

// 超时中间件放在所有请求处理逻辑的最前面
server.use((req, res, next) => {
  req.setTimeout(5000, () => {
    console.log('req timeout!');
    // 未发送响应时先返回超时错误
    if (!res.headersSent) {
      res.status(408).send('Request Timeout');
    }
    // 手动销毁套接字，直接终止连接
    req.destroy();
  });
  next();
});

// 后续再放其他中间件和路由
server.use(express.json());
// 其他业务逻辑...

server.listen(3000, () => {
  // 全局默认超时设为较长值，特殊场景由顶层中间件单独覆盖
  server.setTimeout(120000);
});

生产环境标准化方案 #

对于慢连接上传这类场景，更推荐在Node.js服务前部署反向代理，直接在代理层配置客户端请求超时、最大请求体大小等参数，由代理层直接拦截异常请求，不需要占用Node.js的运行资源，是目前行业通用的最优实现。

业务层耗时操作的取消方法 #

针对业务逻辑中的耗时操作，你可以按场景处理：

• 数据库查询：使用对应数据库驱动内置的超时参数，超时后驱动会自动终止查询、释放连接，无需手动处理。
• 第三方接口请求：使用支持AbortController的HTTP客户端，超时时调用abort方法直接终止请求。
• 本地磁盘I/O：使用带AbortSignal参数的fs异步方法，超时时传递终止信号即可取消I/O操作。

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