WebSocket连接失败常见原因包括：URL协议前缀错误（如误用http://）、服务端未启动或端口被防火墙拦截、本地测试时localhost与127.0.0.1解析差异、反向代理未正确配置Upgrade头等。
WebSocket 不是“用不用”的问题，而是“怎么安全、稳定、可维护地接入项目”。它不是开箱即用的玩具，直接 new WebSocket() 很容易在真实环境里掉坑里。
WebSocket 连接失败常见错误和排查点
浏览器控制台报 Failed to construct 'WebSocket': The URL's scheme must be either 'ws' or 'wss'？说明你用了 http:// 或 https:// 前缀；报 net::ERR_CONNECTION_REFUSED？大概率服务端没跑、端口没暴露或防火墙拦了。
- 必须用
ws://（开发）或wss://（生产），不能混用http协议前缀 - 本地测试时，后端若监听
localhost:8080，前端ws://localhost:8080才合法；若后端只监听127.0.0.1，localhost可能因 DNS 解析失败而连不上 - Chrome 128+ 默认启用 HTTP/2 over WebSocket，但旧版 Nginx（CONNECT 方法，会导致握手卡在
Pending—— 此时要确认 Nginx 配置里有proxy_http_version 1.1;和proxy_set_header Upgrade $http_upgrade;
客户端 onerror 和 onclose 为什么经常不触发
这不是 bug，是设计使然：onerror 只在连接建立**过程中**出错才触发（比如 DNS 失败、TLS 握手失败）；一旦连接成功，后续网络中断、服务器宕机等，只会走 onclose，且往往延迟数秒甚至更久（TCP keepalive 默认超时约 2 小时）。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
- 不要依赖
onerror做重连判断，它几乎捕获不到“断网”类问题 -
onclose的event.code是关键：1006 表示异常关闭（无 close 帧），1001 表示服务端主动关闭，4000+ 通常是业务自定义码 - 真实项目中，必须自己加心跳（ping/pong），否则用户切后台几分钟再回来，连接早已静默失效
Python websockets 库的 serve 为什么启动后就退出
因为 asyncio.run(main()) 执行完 main() 就结束事件循环。而 websockets.serve() 是个协程工厂，它返回一个 server 对象，但不会自动阻塞运行。
- 正确写法是让事件循环一直运行，例如：
await asyncio.Future()（如官方示例），或用asyncio.get_event_loop().run_forever() - 若在 Jupyter 或某些 IDE 里运行，
asyncio.run()可能被重复调用导致 RuntimeError：Event loop is closed —— 改用asyncio.new_event_loop()+set_event_loop()更稳妥 - 生产部署别用
python server.py直启，要用uvicorn或hypercorn托管，它们内置了进程管理、日志、信号处理
要不要自己封装 WebSocket 类
小项目可以，中大型项目建议直接用 Socket.IO 或 SignalR。原生 WebSocket 缺少三样东西：自动重连、消息确认、协议分帧（比如二进制 vs 文本、大消息分片）。自己补这些逻辑，代码量很快超过业务本身。
- 如果只是发日志、广播状态、简单指令，原生够用；但涉及“发送后必须收到 ACK”“消息必须按序到达”“断线期间消息要暂存”，就得上带协议栈的方案
-
Socket.IO默认 fallback 到长轮询，兼容性好，但协议开销大；SignalR在 .NET 生态里集成度高，JS 客户端也轻量 - 真要手写封装，至少保留
send()的 Promise 化（避免 send 后立即 close）、加重试队列、把 ping/pong 做成可配置周期
真正难的从来不是“连上”，而是“连得稳、断得清、消息不丢、扩容不崩”。这些细节藏在心跳间隔、关闭帧语义、反向代理超时设置、TLS 会话复用开关里——而不是第一行 new WebSocket()。
