WebSocket connection failed握手失败原因-常见问题-PHP中文网

websocket连接失败大概率发生在http upgrade请求阶段，需依次排查：一、服务端未启动或监听地址错误；二、反向代理缺失upgrade头配置；三、协议与子协议不匹配；四、跨域及安全策略拦截；五、浏览器扩展干扰。

websocket connection failed握手失败原因

如果您尝试建立 WebSocket 连接，但控制台报出 WebSocket connection to 'wss://' failed 或类似握手失败错误，则问题大概率发生在 HTTP Upgrade 请求阶段。以下是定位与修复该问题的具体路径：

一、服务端未启动或监听地址配置错误

WebSocket 握手依赖服务端在指定 IP 和端口上主动接受 Upgrade 请求。若服务进程未运行、监听地址绑定为 127.0.0.1（而非 0.0.0.0）、或端口未实际暴露，客户端将收到 net::ERR_CONNECTION_REFUSED。

1、执行 ps aux | grep websocket（Linux/macOS）或 tasklist | findstr "node"（Windows）确认服务进程是否存在。

2、检查服务启动日志中是否输出类似 server listening on 0.0.0.0:8080 的绑定信息，而非仅 listening on 127.0.0.1:8080。

3、使用 telnet your-server-ip 8080 或 nc -zv your-server-ip 8080 验证端口在远程可连通。

二、反向代理（Nginx/ELB/SLB）缺少 Upgrade 头转发配置

当 WebSocket 流量经过 Nginx、华为云 ELB、阿里云 SLB 等中间件时，若未显式透传 Upgrade 协议头，服务端无法识别并完成握手，直接返回 400 Bad Request。

1、检查 Nginx 配置中是否存在以下三行（缺一不可）：

2、proxy_http_version 1.1;

3、proxy_set_header Upgrade $http_upgrade;

4、proxy_set_header Connection "upgrade";

5、对于华为云 ELB，请进入监听器配置页，将空闲超时调高至 ≥ 300 秒，并确认协议类型为 TCP 或 HTTPS（非 HTTP）。

三、协议与子协议不匹配

客户端调用 new WebSocket(url, ['json-v1']) 时，服务端必须在响应中携带 Sec-WebSocket-Protocol: json-v1，否则浏览器会终止握手并抛出 CORS error 或 400。

WebSocket 8.18.2

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

下载

1、在浏览器开发者工具 Network 标签页中，筛选 ws 或 wss 类型请求，点击该请求查看 Response Headers。

2、确认响应头中是否存在 Sec-WebSocket-Protocol 字段，且其值与客户端传入的数组元素完全一致（区分大小写与顺序）。

3、若服务端未实现子协议协商逻辑，请临时移除客户端第二个参数，改为 new WebSocket(url) 进行验证。