WebSocket、SSE 与实时消息通信
🎯 引言
学完这篇文章,你能分别建立单向推送与双向连接,并在连接结束时释放资源。
⚖️ 按通信方向选择方式
普通 HTTP 适合一次请求获得一次结果。SSE 在一个 HTTP 响应中持续发送文本事件,适合进度或通知;WebSocket 建立双方都能主动发送消息的连接,适合聊天或协作。
实时连接不是“永远不会断”。客户端切网、代理超时或服务重启都可能中断,是否重连、如何补齐消息要由应用约定。
📡 SSE 一条消息用空行结束
新建 sse.mjs,先定义事件发送:
function sendEvent(res, event, data) {
return res.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
}
event 是名字,data 是文本,这里把对象转成 JSON。末尾空行表示这一条事件完整;缺少它时客户端可能继续等待。
⏱ 持续推送并清理连接
添加完整处理函数,每秒发送当前时间:
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 表示缓冲积压,本例直接断开过慢连接,避免无限堆积;实际应用可以按业务选择暂停或丢弃可替代更新。
新建启动文件:
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,创建本机服务并限制每条消息大小:
import { WebSocketServer } from 'ws';
const server = new WebSocketServer({ host: '127.0.0.1', port: 3001, maxPayload: 16 * 1024 });
添加连接处理:
server.on('connection', socket => {
socket.on('error', console.error);
socket.on('message', data => {
socket.send(`收到:${data.toString()}`);
});
});
message 事件在每条消息到达时触发。本例只回显文本,没有身份和房间权限,是本机协议演示;正式连接建立前要验证身份、检查允许来源,收到每种消息后还要校验结构和权限。
🧪 用客户端完成一次双向通信
启动服务后,新建 ws-client.mjs,使用内置 WebSocket 客户端:
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 示例,观察前者服务器主动持续发送,后者客户端发送后收到回应;断开客户端后检查没有残留定时任务。
// 请在这里编写代码或记录验证结果
