NodeJS中net.Socket完全关闭的定义及双向关闭监听方法问询

我用Node.js v10.19写了一个简单的HTTPS服务器：

const https = require('https');
const options = {key: ..., cert:...};

server = https.createServer(options, (req, res) => {
   ...
   res.end("Hello!\n");
});

server.on('connection', socket => {
   socket.on('close', () => {
      console.log("Close event fired\n");
   });
});

server.listen(5555);

我需要判断客户端连接何时真正结束——这里的“结束”指socket两端均进入CLOSED状态，所有FIN包和最后一个ACK包都已发送完成。

查阅HTTPS、net.Socket、stream.Duplex相关文档后没找到合适方案，现在有两个问题：

1. 文档中“完全关闭”socket的准确定义是什么？
2. 有没有办法实现我的需求？

我尝试过监听net.Socket的close事件，文档说明该事件“在socket完全关闭后触发”，但实际触发时机是服务器发送FIN包后立即执行，早于客户端发送FIN包和服务器发送最后一个ACK包的时间。

观察到的流程： #

* Server FIN *
== 'close' event fired ==
* Client FIN *
* Server ACK *

期望的流程： #

* Server FIN *
* Client FIN *
* Server ACK *
== 触发通知 ==

问题1解答：文档中“完全关闭”的定义 #

Node.js文档里的socket“完全关闭”，指的是本地进程已释放该socket对应的文件描述符及相关资源，和TCP连接的四次握手是否完成没有直接绑定。当服务器调用res.end()主动关闭写流后，本地socket的读写操作已无法进行，Node.js就会触发close事件，此时TCP连接可能仍处于FIN_WAIT_2或TIME_WAIT状态，远端客户端的FIN包和本地的最后ACK包可能还未发送完成。

问题2解答：实现需求的方案 #

在Node.js v10.19中，官方没有直接暴露TCP四次握手完成的事件，但可以通过组合监听socket的多个事件来近似实现需求：

1. 监听end事件：该事件在服务器收到客户端发送的FIN包时触发，意味着客户端已主动关闭连接。
2. 结合close事件和状态标记：在end事件触发后，等待close事件触发，此时服务器已发送最后一个ACK包，TCP四次握手完成。

修改后的示例代码：

server.on('connection', socket => {
  let clientFinReceived = false;

  socket.on('end', () => {
    // 收到客户端发送的FIN包
    clientFinReceived = true;
  });

  socket.on('close', () => {
    if (clientFinReceived) {
      // 此时TCP四次握手已完成，连接完全关闭
      console.log("TCP连接已完全关闭（四次握手完成）\n");
    } else {
      // 仅本地socket关闭，远端未发送FIN包
      console.log("本地socket已关闭，等待客户端FIN包\n");
    }
  });

  // 可选：添加超时处理，应对客户端异常断开的情况
  socket.setTimeout(30000, () => {
    if (!clientFinReceived) {
      console.log("客户端连接超时，强制关闭socket\n");
      socket.destroy();
    }
  });
});

注意事项：

• 如果客户端异常断开（如断电、网络中断），服务器可能永远收不到客户端的FIN包，此时socket会进入FIN_WAIT_2状态直到系统超时，建议添加超时处理避免资源泄漏。
• 不要依赖Node.js的内部私有API（如socket._handle），这类API没有官方维护，版本升级可能导致代码失效。

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