WebSocket连接建立过程 WebSocket握手协议流程【图解】-js教程-PHP中文网

websocket连接需先完成http升级握手：客户端必须发送含upgrade: websocket、connection: upgrade、sec-websocket-key（16字节随机base64）、sec-websocket-version: 13及可选origin的get请求；服务端须校验并返回101状态码及合法sec-websocket-accept响应头，任一缺失或错误均导致400/426等握手失败。

websocket连接建立过程 websocket握手协议流程【图解】

WebSocket连接不是直接建立的，而是通过一次HTTP升级握手完成的——没走通这一步，后续所有通信都不存在。

客户端发的GET请求里必须带哪些Header

浏览器或ws、websockets库发起连接时，底层会自动构造一个HTTP GET请求，但你得知道它到底塞了什么进去，否则遇到400或426错误根本无从排查：

Upgrade: websocket —— 缺了这个，服务器压根不认这是WebSocket请求
Connection: Upgrade —— 和上面配对，单独写keep-alive没用
Sec-WebSocket-Key —— 16字节随机数据Base64编码，比如dGh0bWVuf3JlZGgiMzE4NzY3NzI4NzE=；服务端要用它拼上固定GUID再SHA-1+Base64生成Sec-WebSocket-Accept
Sec-WebSocket-Version: 13 —— 当前唯一通用版本，写12或14会被拒绝
Origin（可选但建议）—— 防跨站滥用，后端常据此做白名单校验

漏掉任意一个必需字段，服务器大概率返回400 Bad Request或直接断连。

服务器响应101状态码时的校验逻辑

服务端收到请求后，不会直接返回101 Switching Protocols，而是先执行一串验证：

检查Upgrade和Connection是否严格匹配，大小写敏感
解析Sec-WebSocket-Key是否为合法Base64且长度够16字节原始数据
计算Sec-WebSocket-Accept：把Key拼上"258EAFA5-E914-47DA-95CA-C5AB0DC85B11"，SHA-1哈希后再Base64编码
若启用了子协议（Sec-WebSocket-Protocol），要确认双方支持交集

任一环节失败，就可能抛InvalidHandshake异常（在websockets库中）或静默关闭连接——此时客户端看到的是EventTarget.onerror或onclose事件，没有具体错误信息。

WebSocket 8.18.2

WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。

下载

为什么本地能连通但部署到Nginx后就失败

这不是代码问题，是反向代理没透传WebSocket头部导致的典型现象：

Nginx默认不转发Upgrade和Connection头，需显式配置：proxy_set_header Upgrade $http_upgrade;和proxy_set_header Connection "upgrade";
如果用了proxy_http_version 1.1但没配上面两行，请求会卡在HTTP 1.1长连接，永远等不到101响应
Cloudflare等CDN默认拦截WebSocket握手，需在仪表盘开启WebSocket支持（开关名通常是“WebSocket”或“Enable WebSocket”）
某些企业防火墙会主动丢弃含Upgrade头的请求，需联系运维放行

这类问题的表现是：前端new WebSocket("wss://...")后长时间无响应，Network面板里看不到101响应，只有pending状态的GET请求。

用Python websockets库调试握手失败

当你用websockets.connect()连不上时，别只看ConnectionRefusedError，重点抓握手阶段的异常：

捕获websockets.exceptions.InvalidHandshake——说明服务器返回了非101响应，或响应头缺失/格式错误
启用日志：logging.basicConfig(level=logging.DEBUG)，能看到build_request和check_response的详细过程
检查服务端handshake.py里的check_request函数是否因Origin不匹配或Sec-WebSocket-Key非法而提前退出
用curl -i -N -H "Connection: Upgrade" -H "Upgrade: websocket" -H "Sec-WebSocket-Key: dGh0bWVuf3JlZGgiMzE4NzY3NzI4NzE=" -H "Sec-WebSocket-Version: 13" http://localhost:8000/ws手动模拟握手，观察原始响应

真正难定位的不是连接失败，而是握手成功后立刻断开——那往往意味着帧解析层出错，已超出握手协议范畴。