Node.js中如何正确销毁Socket以复用指定本地端口？如何区分端口状态？

场景复现 #

服务端代码（监听2222端口） #

import { createServer } from 'net';

const server = createServer((c) => {
  c.setEncoding('utf8');
  c.on('data', (data) => {
    console.log('server', data);
    c.write(data);
  });
  c.on('error', (e) => { throw e; });
});
server.listen(2222);

客户端代码（指定本地端口9999连接服务端） #

import { createConnection } from 'net';

const socket = createConnection({ localPort: 9999, port: 2222, host: 'localhost' });
socket.setEncoding('utf8');
socket.on('data', (data) => {
  console.log('socket data', data);
});
socket.on('connect', () => {
  socket.write('hello');
});
socket.setTimeout(2000);
socket.on('timeout', () => { socket.destroy(); console.log('destroyed'); });
socket.on('error', (e) => { throw e; });

报错信息 #

Error: connect EADDRINUSE 127.0.0.1:2222 - Local (0.0.0.0:9999)
  errno: -48,
  code: 'EADDRINUSE',
  syscall: 'connect',
  address: '127.0.0.1',
  port: 2222

问题说明：客户端指定localPort:9999后，首次运行正常，后续立即运行会触发上述错误，需等待约15秒冷却时间才能复用端口；若不指定localPort，由操作系统自动分配空闲端口则无此问题。

技术问题解答 #

1. 是否存在正确销毁Socket的方法，使其能立即被再次使用？ #

有，通过设置Socket的SO_REUSEADDR选项即可实现端口立即复用。在Node.js中，只需在客户端Socket创建后、连接前调用socket.setReuseAddr(true)，该选项允许操作系统跳过TIME_WAIT状态的冷却时间，直接复用端口。

修改后的客户端代码示例：

import { createConnection } from 'net';

const socket = createConnection({ localPort: 9999, port: 2222, host: 'localhost' });
socket.setReuseAddr(true); // 启用端口复用
socket.setEncoding('utf8');
socket.on('data', (data) => {
  console.log('socket data', data);
});
socket.on('connect', () => {
  socket.write('hello');
});
socket.setTimeout(2000);
socket.on('timeout', () => { socket.destroy(); console.log('destroyed'); });
socket.on('error', (e) => { throw e; });

原理：SO_REUSEADDR是TCP协议的标准选项，它允许绑定处于TIME_WAIT状态的端口，避免因等待2MSL时间导致的端口不可用问题。

2. 若无法立即复用，能否验证Socket处于“冷却中”状态，以区分端口被其他进程占用的情况？ #

可以通过两种方式区分：

• 代码层面检测：尝试用SO_REUSEADDR选项绑定目标端口，如果绑定成功，说明端口处于TIME_WAIT（冷却）状态；如果绑定失败且报错仍为EADDRINUSE，则说明端口被其他进程占用。
  示例检测代码：

  import { createServer } from 'net';
  
  function checkPortStatus(port) {
    return new Promise((resolve) => {
      const tempServer = createServer();
      tempServer.on('error', (err) => {
        if (err.code === 'EADDRINUSE') {
          // 启用SO_REUSEADDR后再次尝试绑定
          tempServer.setReuseAddr(true);
          tempServer.listen(port, () => {
            tempServer.close();
            resolve('冷却中（TIME_WAIT）');
          });
          tempServer.on('error', () => {
            resolve('被其他进程占用');
          });
        } else {
          resolve('未知状态');
        }
      });
      tempServer.listen(port, () => {
        tempServer.close();
        resolve('可用');
      });
    });
  }
  
  // 调用示例
  checkPortStatus(9999).then(status => console.log(`端口状态：${status}`));
  

• 系统命令排查：通过系统工具查看端口状态。比如Linux用ss -tulpn | grep :9999，macOS用lsof -i :9999：
  • 如果显示端口处于TIME_WAIT状态且无关联进程ID，说明是冷却中；
  • 如果显示有明确的进程ID（PID）关联，说明端口被其他进程占用。

程序退出后Socket仍不可用的理论分析 #

程序退出后端口仍不可用，核心原因是TCP协议的TIME_WAIT状态设计：

1. TIME_WAIT的作用：当TCP连接关闭时，主动关闭方会进入TIME_WAIT状态，持续时间为2×MSL（MSL即最大报文生存时间，通常为30秒，所以TIME_WAIT默认持续15-60秒）。这个状态是为了：
   • 确保最后一个ACK确认包能被对方接收，避免对方重发FIN包导致连接异常；
   • 防止网络中延迟的旧连接报文干扰新创建的同端口连接。
2. 异常退出的影响：如果程序被强制终止（比如kill -9），Socket可能没有完成完整的FIN/ACK握手流程，导致端口进入TIME_WAIT或CLOSE_WAIT状态，同样会占用端口直到状态过期。
3. 默认限制：操作系统默认不允许绑定处于TIME_WAIT状态的端口，必须等待状态过期后才能复用，这就是为什么需要等待冷却时间的原因。

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