WebSocket通过new WebSocket(url)建立持久双向连接,支持ws/wss协议;监听open/close/error/message事件处理状态与消息;send()发送数据需确保readyState为OPEN;需服务端WebSocket支持及Nginx等中间件配置Upgrade头。

JavaScript 用 WebSocket 实现实时双向通信,核心就是创建一个持久连接,客户端和服务端都能随时发消息,不用轮询或长连接模拟。
如何建立 WebSocket 连接
用 new WebSocket(url) 创建实例,URL 必须是 ws:// 或加密的 wss://(类似 HTTP/HTTPS)。
常见写法:
const ws = new WebSocket("wss://example.com/chat");- 连接成功后触发
open事件,可在此发送首次消息 - 失败会触发
error,断开触发close,需主动监听处理
如何收发消息
发消息用 ws.send(),参数必须是字符串或 ArrayBuffer/Blob;接收用 message 事件。
立即学习“Java免费学习笔记(深入)”;
示例:
ws.onmessage = (e) => { console.log("收到:", e.data); };-
ws.send("hello server");—— 发文本 -
ws.send(JSON.stringify({ type: "login", user: "Alice" }));—— 常用 JSON 格式传结构化数据
如何处理连接状态与重连
ws.readyState 表示当前状态:0=CONNECTING、1=OPEN、2=CLOSING、3=CLOSED。别在非 OPEN 状态调 send(),否则报错。
自动重连建议逻辑:
- 监听
close事件,延迟几秒后尝试新建连接 - 限制重试次数,避免无限循环(比如最多 5 次)
- 连接成功后清空重试计数器
服务端配合要点(简要说明)
前端 WebSocket 要正常工作,后端必须是真正的 WebSocket 服务,不是普通 HTTP 接口。常用方案有:
- Node.js:用
ws库(轻量)、Socket.IO(带降级和封装,但非原生 WS) - Python:用
websockets库 - Java:Spring WebFlux + WebSocket 支持
- 注意:Nginx 或 CDN 可能默认不转发 WebSocket 升级请求,需配置
Upgrade和Connection头
基本上就这些。WebSocket 本身不复杂,但连接管理、错误恢复、消息协议设计这些细节容易忽略。











