WebSocket连接超时必须主动控制，因各环节超时机制独立：JS客户端需用setTimeout监控readyState；gorilla/websocket靠HandshakeTimeout管控握手全过程；Nginx需配置proxy_read_timeout防代理截断；Java-WebSocket须用Future包裹connectBlocking()实现超时。
WebSocket连接超时不能靠“等它自己断”，必须主动控制——因为不同环节的超时机制彼此独立，漏掉任何一个都可能卡住线程、拖垮服务。
connect() 本身不带超时：JS 客户端必须手动兜底
浏览器原生 WebSocket 构造函数不接受超时参数，ws.readyState 从 0（CONNECTING）变到 1（OPEN）的时间完全不可控，弱网下可能卡 20–30 秒才触发 onerror 或 onclose。
正确做法是用 setTimeout 主动监控：
- 实例化后立即启动计时器，比如设为
5000毫秒 - 一旦
readyState === 1，清除定时器 - 超时未就绪，调用
ws.close()并触发重连逻辑 - 注意：不能只依赖
onerror，某些网络中断场景下该回调根本不会触发
gorilla/websocket 的 HandshakeTimeout 是唯一能管住“握手阶段”的配置
Go 生态中，gorilla/websocket 的 Dialer.HandshakeTimeout 是唯一真正作用于 TCP 连接建立 + HTTP 升级全过程的超时项。它和底层 net.DialTimeout 协同生效，但优先级更高。
常见误操作：
- 只设
SetReadDeadline或SetWriteDeadline—— 这俩对连接建立阶段完全无效 - 把
HandshakeTimeout设得太短（如1s），内网环境容易误杀正常连接 - 在服务端用
Upgrader.HandshakeTimeout，但客户端没配对应值，导致两端感知不一致
建议值：15 * time.Second（公网）、5 * time.Second（K8s Pod 间调用）。
Nginx 代理层的 proxy_read_timeout 决定空闲连接存活上限
如果你的 WebSocket 服务前挂了 Nginx，那么即使后端代码设置了所有超时，Nginx 默认的 60s 也会强行切断静默连接——这不是你的程序问题，是代理层截断。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
关键配置必须同时满足三项：
-
proxy_http_version 1.1（强制升到 HTTP/1.1，否则 Upgrade 头被忽略） -
proxy_set_header Upgrade $http_upgrade和proxy_set_header Connection "upgrade" -
proxy_read_timeout 3600（单位秒，设为 0 表示不限制，但不推荐）
注意：proxy_send_timeout 控制的是 Nginx 向后端发数据的超时，一般无需调整；真正影响客户端体验的是 proxy_read_timeout。
Java-WebSocket 库的 connectBlocking() 没有超时参数，得靠 Future 包裹
org.java_websocket.client.WebSocketClient.connectBlocking() 内部调用的是无参 socket.connect()，完全依赖操作系统 TCP 层默认超时（Linux 约 20–30 秒，Windows 可达 75 秒）。你无法通过构造器或 setter 修改它。
安全可行的解法只有这一种：
- 用
Executors.newSingleThreadExecutor()提交连接任务 - 拿到
Future<?>后调用get(5, TimeUnit.SECONDS) - 超时则
future.cancel(true)，并确保onError被触发 - 不要尝试反射修改 socket 或继承重写私有方法——v1.5.3+ 版本已屏蔽这些入口
这个模式看似绕，但它把超时控制权完全收回到业务线程，避免线程池被阻塞型连接拖垮。
真正麻烦的不是设哪个参数，而是意识到：一次 WebSocket 连接要经过 DNS、TCP 握手、TLS 握手、HTTP 升级、协议帧交换多个阶段，每个阶段都有自己的超时主体。少配一处，就可能在凌晨三点收到告警说“连接数突增但无流量”。
