WebSocket是浏览器与服务器间持久化、全双工通信协议，解决HTTP轮询效率低问题；前端用new WebSocket()创建连接，后端需支持协议升级；使用时需处理重连、认证、消息分包及强制加密。
WebSocket 是浏览器与服务器之间建立持久化、全双工通信通道的协议。它不像 HTTP 那样每次请求都要重新握手，而是一次连接后双方可以随时互相发消息，适合聊天、实时通知、协作编辑、行情推送等场景。
为什么需要 WebSocket？
HTTP 是“请求-响应”模式：浏览器发请求，服务器回一次数据，连接就断了。想实时获取新消息，只能靠轮询（反复发请求）或长轮询（卡住响应等数据），效率低、开销大、延迟高。WebSocket 解决了这个问题——连接建立后，服务端有数据就能立刻推给浏览器，反之亦然。
如何在浏览器中创建 WebSocket 连接？
前端用 new WebSocket(url) 即可发起连接，URL 以 ws://（非加密）或 wss://（加密，推荐）开头：
- 连接成功后触发
onopen回调 - 收到消息时触发
onmessage，事件对象的data就是服务器发来的数据 - 调用
send()方法可向服务端发消息（支持字符串、Blob、ArrayBuffer） - 出错或断开时会触发
onerror或onclose
示例：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
const ws = new WebSocket('wss://example.com/chat');ws.onopen = () => { ws.send('Hello server!'); };
ws.onmessage = (event) => { console.log('收到:', event.data); };
ws.onclose = () => { console.log('连接已关闭'); };
后端如何支持 WebSocket？（以 Node.js + ws 库为例）
浏览器只是客户端，服务端也得支持 WebSocket 协议才能响应升级请求：
- 用
ws库监听 HTTP 服务器的 upgrade 事件，把连接升级为 WebSocket - 每个连接对应一个
WebSocket实例，通过send()向该客户端发消息 - 用
on('message')接收客户端消息；用on('close')或on('error')处理异常 - 若需广播消息给所有在线用户，需自行维护连接列表（如用 Map 存 socket 实例）
简单服务端示意：
const WebSocket = require('ws');const wss = new WebSocket.Server({ port: 8080 });
wss.on('connection', (ws) => {
ws.send('欢迎加入');
ws.on('message', (data) => {
console.log('收到:', data.toString());
wss.clients.forEach(client => {
if (client.readyState === WebSocket.OPEN) {
client.send(`广播: ${data}`);
}
}
});
ws.on('close', () => console.log('用户离开'));
});
使用时要注意什么？
- 连接可能因网络、服务重启等原因断开，前端应监听
onclose并实现自动重连（带退避策略更稳妥） - WebSocket 不支持跨域 Cookie，登录态通常靠 token 放在 URL 或首次 send 中传递
- 消息无内置分包/粘包机制，大数据建议自己加协议头（如 JSON + length 字段）或用 MessagePack 等序列化
- 生产环境务必用
wss://，否则现代浏览器会拦截混合内容
基本上就这些。WebSocket 本身协议简单，关键在于连接管理、错误恢复和业务消息设计。
