为何Linux下NodeJS Net::socket.readyState断连时不变化，Windows下正常？

问题原因 #

• TCP栈实现差异：Linux与Windows的TCP协议栈对连接失效的检测逻辑不同。Linux默认的TCP keepalive参数（如tcp_keepalive_time、tcp_keepalive_intvl、tcp_keepalive_probes）阈值更宽松，当物理网线断开或远程IP变更后，系统不会快速探测到连接失效，导致Node.js的readyState仍维持open状态。
• readyState的局限性：该属性仅反映socket的本地状态，只有当socket收到明确的FIN/RST断开包，或本地触发错误时才会更新。Linux下网络异常时，TCP栈不会主动快速发送探测包，Node.js无法实时感知连接已中断。

解决办法 #

调整Linux系统TCP keepalive参数 #

• 临时生效（重启后失效）：

  sysctl -w net.ipv4.tcp_keepalive_time=600
  sysctl -w net.ipv4.tcp_keepalive_intvl=60
  sysctl -w net.ipv4.tcp_keepalive_probes=3
  

  说明：设置连接闲置10分钟后开始发送探测包，每隔60秒发送一次，连续3次无响应则判定连接失效。
• 永久生效：编辑/etc/sysctl.conf，添加以下内容后执行sysctl -p：

  net.ipv4.tcp_keepalive_time=600
  net.ipv4.tcp_keepalive_intvl=60
  net.ipv4.tcp_keepalive_probes=3
  

在Node.js中主动启用socket keepalive #

创建socket后手动开启keepalive并配置参数，覆盖系统默认值：

const net = require('net');
const socket = new net.Socket();

socket.connect({ host: 'remote-ip', port: 1234 }, () => {
  // 启用keepalive，60秒后开始发送探测包
  socket.setKeepAlive(true, 60000);
});

更可靠的连接状态监控方式 #

• 应用层心跳机制：这是跨平台最可靠的方案，不受TCP栈实现差异影响。客户端定期向服务端发送心跳包，服务端收到后回复响应，若客户端在指定时间内未收到响应，则判定连接失效。
  示例代码：

  const net = require('net');
  const socket = new net.Socket();
  let heartbeatTimer;
  let heartbeatTimeout;
  
  socket.connect({ host: 'remote-ip', port: 1234 }, () => {
    // 每10秒发送一次心跳包
    heartbeatTimer = setInterval(() => {
      if (socket.writable) {
        socket.write('PING');
        // 设置超时检测，15秒未收到响应则判定断开
        heartbeatTimeout = setTimeout(handleDisconnect, 15000);
      } else {
        handleDisconnect();
      }
    }, 10000);
  
    // 监听服务端心跳响应
    socket.on('data', (data) => {
      if (data.toString().trim() === 'PONG') {
        clearTimeout(heartbeatTimeout);
      }
    });
  });
  
  function handleDisconnect() {
    clearInterval(heartbeatTimer);
    clearTimeout(heartbeatTimeout);
    socket.destroy();
    console.log('连接已断开');
    // 可在此添加重连逻辑
  }
  
  // 监听socket错误与关闭事件
  socket.on('error', (err) => {
    handleDisconnect();
    console.error('socket错误:', err);
  });
  
  socket.on('close', () => {
    handleDisconnect();
    console.log('socket已关闭');
  });
  

• 监听error和close事件：当连接真正失效时，Node.js会跨平台触发这两个事件，可直接通过事件回调更新连接状态。
• 利用socket.write回调：调用socket.write时，若写入失败（如连接已断），回调会返回错误信息，以此判断连接状态。

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