WebSocket是协议，Socket.IO是需前后端配套使用的库；前者原生支持、轻量快速但需自研重连降级，后者自动处理兼容性与稳定性但协议不兼容、不可混用。
WebSocket 是协议，Socket.IO 是配套生态
原生 WebSocket 是浏览器内置的 RFC 6455 协议，调用 new WebSocket('ws://...') 就能连，不依赖任何库。而 socket.io 是一个完整通信栈：前端必须用 socket.io-client，后端（如 FastAPI）得配 python-socketio 或 Node.js 的 socket.io，两边版本还得对得上——混用必报错，比如 Connection closed before receiving a handshake response。
常见错误现象：
- 用
new WebSocket('ws://localhost:8000')去连socket.io服务 → 立刻断连 - 用
io('http://localhost:8000')去连原生WebSocket路由 →socket.connected永远是false
连接失败时，Socket.IO 自动降级不是“兜底 WebSocket”
Socket.IO 所谓“兼容旧浏览器”，本质是检测到 WebSocket 不可用时，主动切换成 HTTP 长轮询（polling），而不是继续尝试或修复 WebSocket 连接。这个过程对开发者透明，但会带来明显代价：
- 延迟升高：每次消息都走 HTTP 请求，RTT 翻倍
- 连接数暴增：每个客户端维持多个 polling 连接，压垮 Nginx 或负载均衡器
- 服务端内存压力大：长轮询连接无法像 WebSocket 那样复用底层 socket
如果你的部署环境明确可控（比如内网 App、现代浏览器用户占比 >98%），降级反而成了冗余负担。
发消息方式不同，事件模型不可互换
原生 WebSocket 只有 send()，传的是原始字符串或 ArrayBuffer，格式全靠你定；socket.io 强制走事件机制：emit('event_name', data, callback)，服务器收到后必须用 on('event_name', ...) 显式监听。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
关键差异点：
-
emit()支持 ACK 回调，比如socket.timeout(5000).emit('msg', 'hi', (err, res) => {...})，原生 WebSocket 没这功能 -
socket.broadcast.emit()一行广播给除自己外所有人，原生需遍历clients并手动过滤 -
socket.join('room1')+io.to('room1').emit()实现房间隔离，原生得自己维护连接→房间映射表
FastAPI 中选 Socket.IO 得额外装包和改路由
FastAPI 官方只原生支持 WebSocket，要跑 socket.io 必须引入 python-socketio 并搭配 ASGI 服务器（如 uvicorn 或 hypercorn），不能直接用 @app.websocket 装饰器。
典型配置要点：
- 后端启动需用
sio = socketio.AsyncServer(async_mode='asgi')，再挂载为 ASGI middleware - 前端必须加载
https://cdn.socket.io/4.0.0/socket.io.min.js（版本要和后端一致） - Nginx 需显式透传升级头：
proxy_http_version 1.1;、proxy_set_header Upgrade $http_upgrade;、proxy_set_header Connection "upgrade";
真正容易被忽略的是版本对齐——python-socketio==5.10.0 对应前端 socket.io-client@4.7.5，错一个 patch 版本就可能握手失败，且错误日志里不报具体原因。
