Node.js(Sails.js)服务器偶发请求无响应问题排查求助

一、HTTP框架版本兼容性问题 #

你的应用使用Sails.js 0.12.14（依赖Express 3.21.3），这两个都是2015年左右的老版本，和Node.js 14.17.1存在明显的跨版本兼容性gap：

• Express 3.x的响应处理逻辑是针对Node.js 0.10/0.12设计的，在Node.js 14的事件循环机制下，res.json()内部调用的res.end()可能没有正确触发TCP socket的PSH/ACK标记，导致数据发送完成后连接无法正常关闭。
• 旧版Express依赖的connect库存在socket处理bug，偶发会导致响应结束后socket未被正确回收，保持ESTABLISHED状态。

调整动作：

• 临时补丁：在控制器的contactDetails方法末尾，调用res.end()强制关闭响应（即使res.json()已经执行）：

  function contactDetails(req, res) {
    // 原有逻辑
    res.json({/* 静态JSON内容 */});
    // 新增强制结束逻辑
    res.end();
  }
  

• 修正res.json()改写逻辑，确保触发socket flush：

  const originalJson = res.json;
  res.json = function(data) {
    const result = originalJson.call(this, data);
    // 手动触发socket刷新
    if (this.socket) this.socket.flush();
    console.log('res.json() done');
    return result;
  };
  

二、中间件改写逻辑异常 #

你提到中间件改写了res.json()，虽然输出了日志，但可能存在逻辑漏洞：

• 改写后的方法没有正确调用原始res.json()的异步回调，导致响应结束的流程被挂起。
• 中间件链中后续的某个钩子（比如Sails的afterResponse hook）持有响应对象引用，阻塞了连接关闭。

调整动作：

• 检查改写res.json()的代码，确保没有覆盖原始方法的返回值或回调逻辑，不要在日志输出后添加额外的异步操作。
• 临时禁用非必要的全局中间件和Sails钩子，排查是否是第三方钩子导致的问题。

三、系统TCP参数配置不合理 #

服务器的TCP保活和连接回收参数默认值过于宽松，无法及时处理僵死连接：

• 默认的TCP保活时间是7200秒（2小时），远超过场景需求，导致僵死的ESTABLISHED连接无法被系统及时检测并回收。
• tcp_fin_timeout默认60秒，TIME_WAIT状态的连接回收慢，积累过多会占用系统资源。

调整动作：

• 执行以下Linux系统命令临时调整参数（重启后失效）：

  # 缩短TCP保活检测时间
  sysctl -w net.ipv4.tcp_keepalive_time=300
  sysctl -w net.ipv4.tcp_keepalive_intvl=30
  sysctl -w net.ipv4.tcp_keepalive_probes=3
  # 加快TIME_WAIT连接回收
  sysctl -w net.ipv4.tcp_fin_timeout=30
  

• 永久生效：将上述参数写入/etc/sysctl.conf，然后运行sysctl -p。

四、Node.js内部或第三方依赖偶发阻塞 #

虽然自定义代码无阻塞，但旧依赖包或Node.js内部可能存在偶发问题：

• 项目中的第三方依赖（如数据库驱动、缓存客户端）版本过旧，存在内存泄漏或事件循环阻塞的bug。
• Node.js 14的libuv库与旧版依赖的兼容性问题，导致socket写入队列偶发无法刷新。

调整动作：

• 使用node --trace-event-categories node.async_hooks启动应用，出现问题时抓取事件循环profile，定位阻塞点。
• 升级关键第三方依赖到兼容Node.js 14的版本，比如把旧版mysql驱动升级到mysql2的兼容版本。

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