WebSocket、SSE 与实时消息通信

分别建立单向推送与双向连接,并在连接结束时释放资源

🎯 引言

学完这篇文章,你能分别建立单向推送与双向连接,并在连接结束时释放资源。

⚖️ 按通信方向选择方式

普通 HTTP 适合一次请求获得一次结果。SSE 在一个 HTTP 响应中持续发送文本事件,适合进度或通知;WebSocket 建立双方都能主动发送消息的连接,适合聊天或协作。

实时连接不是“永远不会断”。客户端切网、代理超时或服务重启都可能中断,是否重连、如何补齐消息要由应用约定。


📡 SSE 一条消息用空行结束

新建 sse.mjs,先定义事件发送:

sse.mjs
function sendEvent(res, event, data) {
    return res.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
}

event 是名字,data 是文本,这里把对象转成 JSON。末尾空行表示这一条事件完整;缺少它时客户端可能继续等待。


⏱ 持续推送并清理连接

添加完整处理函数,每秒发送当前时间:

sse.mjs
export function events(req, res) {
    res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache' });
    res.flushHeaders();
    const timer = setInterval(() => {
        if (!sendEvent(res, 'clock', { time: new Date().toISOString() })) res.destroy();
    }, 1000);
    res.once('close', () => clearInterval(timer));
}

客户端断开就停止定时器。write 返回 false 表示缓冲积压,本例直接断开过慢连接,避免无限堆积;实际应用可以按业务选择暂停或丢弃可替代更新。

新建启动文件:

sse-server.mjs
import express from 'express';
import { events } from './sse.mjs';

const app = express();
app.get('/events', events);
app.listen(3002, '127.0.0.1');

启动后用不缓冲输出的 curl 观察:

curl -N http://127.0.0.1:3002/events

每秒收到一条 clock 事件,Ctrl+C 断开后服务器清除对应定时器。


🖥 浏览器用 EventSource 接收

若把 events 处理函数挂到前端同源的 /events 路由,页面可以使用:

const source = new EventSource('/events');
source.addEventListener('clock', event => {
    console.log(JSON.parse(event.data).time);
});
window.addEventListener('pagehide', () => source.close());

这段是浏览器代码,不能在 Node.js 中直接当页面运行。不同源则需前篇 CORS 配置。EventSource 通常会自动重连,但不会凭空补齐丢失消息;需要事件 ID、服务端保存和续传规则才能恢复。

原生 EventSource 不能直接设置自定义 Authorization 头。认证推送要选择合适的 Cookie 方案或其他带认证头的流读取方式,不把长期 Token 放在 URL。


🔄 WebSocket 让客户端也能持续发送

安装 WebSocket 服务端库:

npm install ws@8.22.0

新建 ws-server.mjs,创建本机服务并限制每条消息大小:

ws-server.mjs
import { WebSocketServer } from 'ws';

const server = new WebSocketServer({ host: '127.0.0.1', port: 3001, maxPayload: 16 * 1024 });

添加连接处理:

ws-server.mjs
server.on('connection', socket => {
    socket.on('error', console.error);
    socket.on('message', data => {
        socket.send(`收到:${data.toString()}`);
    });
});

message 事件在每条消息到达时触发。本例只回显文本,没有身份和房间权限,是本机协议演示;正式连接建立前要验证身份、检查允许来源,收到每种消息后还要校验结构和权限。


🧪 用客户端完成一次双向通信

启动服务后,新建 ws-client.mjs,使用内置 WebSocket 客户端:

ws-client.mjs
const socket = new WebSocket('ws://127.0.0.1:3001');
socket.addEventListener('open', () => socket.send('hello'));
socket.addEventListener('message', event => {
    console.log(event.data);
    socket.close();
});
socket.addEventListener('error', () => console.error('连接失败'));

运行后输出“收到:hello”并关闭连接。正式 HTTPS 页面使用加密的 wss://,反向代理也要支持升级连接。WebSocket 不依赖 CORS 头授权,不能因为配置了 HTTP CORS 就认为它已受保护。


🧹 断线与服务退出也属于实现的一部分

长连接要限制消息大小、发送积压和每用户连接数。需要检测失联时使用协议心跳,超过期限主动清理,不能只等业务消息出现。

SSE 经过代理时通常要关闭相应响应缓冲;WebSocket 需要正确转发升级请求。服务退出时主动结束这些连接,否则等待普通 HTTP 请求结束的逻辑可能一直等不完。


❓ 知识问答

Q1:实时推送是不是比轮询总是更好?

不是。更新很少、实现要求简单时,定时查询也可能足够。长连接增加连接管理与恢复工作。

Q2:WebSocket 连接通过认证后,每条消息就可信了吗?

不是,还要校验消息类型、大小、字段和目标资源权限。

Q3:断线重连等于消息不丢吗?

不等于,需要服务端保存消息、客户端提供位置标记并设计补齐策略。


🧪 小练习

分别运行 SSE 和 WebSocket 示例,观察前者服务器主动持续发送,后者客户端发送后收到回应;断开客户端后检查没有残留定时任务。

// 请在这里编写代码或记录验证结果