首先完成“使用 ws 库构建你的第一个 WebSocket 服务器”即可解锁本课程。转到上一课

Introduction

在实时的 Node.js 应用中,WebSocket 连接不仅仅是一条“打开的管道”。它是一个活的实体:会打开、发送数据、可能静默死亡、也可能以意外的方式失效。如果你的代码未显式管理该生命周期的每个阶段,服务器将出现内存泄漏、僵尸连接累积,最终崩溃。本课程覆盖完整的生命周期:open 事件、close 事件、error 事件,以及用于检测死对端的 heartbeat pings。

The Connection Lifecycle

在 Node.js 中,每个 WebSocket 连接都会经历四个可观察的状态。库(这里使用流行的 `ws` 包)会发出你可以监听的事件:`connection`、`message`、`close`、`error`。一种常见模式是将所有处理程序包裹在一个函数中,以便每个新客户端获得相同的生命周期管理。

javascript
const WebSocket = require('ws');
const wss = new WebSocket.Server({ port: 8080 });
wss.on('connection', (ws, req) => {
console.log('Client connected:', req.socket.remoteAddress);
ws.on('message', (data) => {
console.log('Received:', data.toString());
ws.send(`Echo: ${data}`);
});
ws.on('close', (code, reason) => {
console.log(`Client disconnected. Code: ${code}, Reason: ${reason}`);
});
ws.on('error', (err) => {
console.error('Socket error:', err.message);
});
});
WebSocket 连接的 4 状态生命周期图:CONNECTING -> OPEN -> CLOSING -> CLOSED,并附带相应事件

Close code 遵循 WebSocket 规范。常见取值:`1000` 表示由任一方发起的正常关闭,`1001` 表示客户端正在离开,`1006` 是臭名昭著的“非正常关闭”,通常表示网络异常导致连接死亡。

Heartbeats: Detecting Dead Clients

TCP 不会在客户端静默消失时通知你——连接就那样半开着,直到其他东西发现问题。WebSocket 协议通过称为 ping(opcode 0x9)和 pong(0xA)的控制帧来解决这一点。任一端都可以发送 ping;对端必须以包含相同载荷的 pong 作出回应。如果在超时窗口内没有收到 pong,连接就被视为死亡,应当终止。

The `ws` library exposes `ws.ping()`, `ws.pong()`, and a built-in `heartbeat` option that does most of the work. The pattern below is the canonical implementation.

javascript
const WebSocket = require('ws');
const wss = new WebSocket.Server({ port: 8080 });
function heartbeat() {
this.isAlive = true;
}
wss.on('connection', (ws) => {
ws.isAlive = true;
ws.on('pong', heartbeat);
ws.on('message', (data) => {
ws.send(`Echo: ${data}`);
});
ws.on('close', () => {
console.log('Connection closed, cleanup done');
});
ws.on('error', (err) => {
console.error('Connection error:', err.message);
});
});
const interval = setInterval(() => {
wss.clients.forEach((ws) => {
if (ws.isAlive === false) {
console.log('Terminating dead connection');
return ws.terminate();
}
ws.isAlive = false;
ws.ping();
});
}, 30000);
wss.on('close', () => clearInterval(interval));

实际运作方式示例:在服务器启动时,对每个新客户端将 `isAlive` 设置为 `true`。每30秒,服务器遍历所有客户端。如果某个客户端在上一轮中已被标记为死亡,则调用 `terminate()`,强制关闭底层 TCP 套接字。否则重置标志位并发送一个 ping 帧。健康的客户端会自动用 pong 响应,从而触发 `pong` 处理程序并重新将 `isAlive` 重置为 `true`。一个死亡的客户端永远不会返回 pong,因此在下一轮中将被终止。

Graceful 处理错误

`error` 事件在协议违反、无效帧和底层套接字失败时触发。如果没有监听器未处理的错误事件将会让你的 Node.js 进程崩溃。始终附带一个监听器,并将其与 `close` 事件配对,因为在大多数情况下错误之后紧接着就是关闭。一个有用的规则:记录错误以用于诊断,但不要在错误处理程序内尝试从 `error` 处理程序中 `send()`——套接字可能已不可用。

javascript
ws.on('error', (err) => {
console.error(`Socket error code=${err.code} message=${err.message}`);
});

错误的 `code` 属性通常包含诸如 `ECONNRESET` 或 `EPIPE` 之类的系统级值。这些是调试提示,而不是要在应用逻辑中作出反应的内容。

总结

管理 WebSocket 生命周期是一种三项习惯的纪律。始终监听 `close` 和 `error`,以便清理僵尸连接和故障。实现一个带有合理间隔的 ping/pong 心跳循环(30 秒是标准值)来检测静默断开。并且不要让未处理的 `error` 事件触发 Node.js 的默认崩溃行为。将这些模式结合起来,即使在网络条件不稳定和成千上万的并发客户端下,也能保持长期实时服务器的稳定性。

课后练习

课程检查点

巩固所学知识,获取作业反馈。

0/1
已回答 · 0/1