Nginx代理WebSocket重连失败主因是配置缺失：必须透传Upgrade和Connection头、设proxy_http_version 1.1、禁用缓冲与压缩，并调大proxy_read_timeout等超时值，同时排除限流、复用及HTTPS会话复用干扰。
WebSocket 代理在大流量下断开后无法正常重连，通常不是单一原因导致，而是 Nginx 配置、后端服务行为、客户端策略和网络环境共同作用的结果。重点排查方向是：连接保持机制是否生效、超时设置是否合理、HTTP 升级头是否透传、以及重连时是否被 Nginx 拒绝或复用异常连接。
检查 Nginx 的 WebSocket 关键配置是否完整
Nginx 默认不识别 WebSocket 协议，必须显式配置才能正确代理升级请求。漏掉任一关键项都可能导致重连失败：
-
必须透传 Upgrade 和 Connection 头：WebSocket 建立依赖 HTTP/1.1 的
Upgrade: websocket和Connection: upgrade，Nginx 默认会过滤这些头，需手动添加：proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection "upgrade"; -
禁用缓冲和压缩：WebSocket 是全双工实时流，启用
proxy_buffering on或gzip on可能截断帧或延迟发送，建议关闭：proxy_buffering off;gzip off; -
设置合理的超时时间：大流量下连接空闲易被中间设备（如 LB、防火墙）中断，需延长 Nginx 的读写和超时时间：
proxy_read_timeout 300;（建议 ≥ 后端心跳间隔）proxy_send_timeout 300;proxy_http_version 1.1;（必须为 1.1）
确认重连请求是否被 Nginx 拒绝或复用旧连接
客户端重连时，若 Nginx 错误地复用了已半关闭的 upstream 连接，或因缓存/限流拦截了新 Upgrade 请求，会导致 400/426/502 等错误：
-
检查 access_log 和 error_log：开启详细日志，重点关注重连时刻的响应状态码、upstream 地址、以及是否出现
upstream prematurely closed connection或client intended to send too large chunked body类错误； -
禁用连接复用（临时验证）：在 location 块中添加
proxy_http_version 1.1;+proxy_set_header Connection '';（清空 Connection 头），并设置proxy_set_header Host $host;，避免因 Host 头缺失或复用导致协议降级； -
排除限流干扰：如果启用了
limit_req，确保它未作用于 WebSocket 路径（如location /ws/ { limit_req off; ... }），否则重连请求可能被限速拒绝。
验证后端服务与客户端的重连逻辑是否兼容 Nginx 行为
Nginx 不终止连接，但可能因超时或异常中断 upstream 连接，此时后端若未及时释放资源，或客户端未正确处理 close frame，都会表现为“连不上”：
-
后端应主动发送 ping/pong 心跳：确保后端定期发 pong（或响应 ping），且间隔小于 Nginx 的
proxy_read_timeout，防止连接被静默断开； -
客户端重连需带退避策略：避免雪崩式重连压垮 Nginx，推荐指数退避（如 1s → 2s → 4s → 最大 30s），并检查是否在重连前主动调用
close()释放旧 socket； -
抓包确认实际握手过程：用
tcpdump -i any port 80 or port 443 -w ws.pcap抓包，在客户端重连瞬间过滤 WebSocket 流（如过滤tcp contains "websocket"），确认 Nginx 是否转发了 Upgrade 请求、后端是否返回了 101 Switching Protocols。
补充：HTTPS 场景下的常见陷阱
若走 HTTPS，还需额外注意：
- SSL 会话复用（session reuse）可能让 Nginx 复用已失效的 TLS 连接，可在 upstream 中加
ssl_session_reuse off;（仅调试用）； - 证书链不全或 OCSP Stapling 异常虽不直接导致 WebSocket 断连，但在重连密集时可能拖慢 TLS 握手，间接影响建连成功率；
- 确保
proxy_ssl_server_name on;开启，尤其当后端是 SNI 多租户部署时，否则可能路由到错误实例。
