要让nginx稳定代理hyperf的websocket服务，关键是超时参数与swoole心跳严格对齐：proxy_read_timeout和proxy_send_timeout均需≥心跳间隔加缓冲（如设为90或86400），并启用proxy_http_version 1.1及proxy_set_header upgrade $http_upgrade；swoole端须在server.php配置heartbeat_check_interval=25、heartbeat_idle_time=60且差值≥20，改后必须重启服务。
要让 Nginx 稳定代理 Hyperf 的 WebSocket 服务（尤其是单机部署场景），关键不是“调大所有超时”，而是让 Nginx 超时参数与 Hyperf+Swoole 的心跳机制严格对齐，避免中间层主动断连。
WebSocket 场景必须配准的三项 proxy 超时
Nginx 默认的 proxy_read_timeout 60s 是 WebSocket 断连最常见的元凶——它和心跳间隔不匹配，就会在连接空闲时直接关闭后端连接。
- proxy_read_timeout：必须 ≥ 心跳发送间隔 + 服务端处理缓冲（推荐设为 86400 或至少 90）。例如心跳每 25 秒发一次，留出 35 秒余量应对网络抖动，90 就是底线。
-
proxy_send_timeout：需与
proxy_read_timeout一致（如都设为 90 或 86400），否则发心跳帧途中被截断，客户端收不到 pong，连接照样断。 - proxy_http_version 1.1 和 proxy_set_header Upgrade $http_upgrade 必须启用，否则 WebSocket 握手在第一秒就失败，根本进不了心跳阶段。
Swoole 心跳参数不能只写 Handler，得改 server.php
Hyperf 的 WebSocket 连接存活由底层 Swoole 控制，不是靠你在 onMessage 里手动发 ping/pong。真正起作用的是 server.php 中的两个配置：
- heartbeat_check_interval：建议设为 25（每 25 秒检查一次客户端是否还活着）
- heartbeat_idle_time：建议设为 60（允许连接空闲最长 60 秒）
二者差值必须 ≥ 20 秒。若设成 30 和 40，弱网下一次 pong 延迟就触发踢出；改完必须重启服务，热更新无效。
其他容易被忽略但影响稳定的细节
单机运行虽无负载均衡压力，但 Nginx 自身资源管理仍需收紧，防止空闲连接堆积：
- keepalive_timeout 设为 60 即可（浏览器兼容性更好，也防长连接泛滥）
- client_header_timeout 和 client_body_timeout 按业务设：普通接口 60s，上传类接口可放宽至 300s，但不要盲目设 0 或极大值
- 确认 Nginx 工作模式为
event，并开启multi_accept on，适配 Swoole 的高并发模型
验证是否生效的简单方法
不用等上线压测，本地就能快速验证：
- 用 curl 检查响应头：
curl -I http://your-domain/ws，确认返回Upgrade: websocket - WebSocket 连接建立后，抓包看是否有周期性 ping/pong 帧（或自定义心跳 JSON），且 Nginx 日志里不再出现
upstream timed out - 故意断网几秒再恢复，观察连接是否自动重连成功，而非直接报
1001或ConnectionClosedError
