swoole超时需分层配置:http server用request_timeout和heartbeat_idle_time,协程客户端需单独设connect/read/write_timeout,且所有配置须在start前设置。

Swoole 的超时不是设一个值就完事的,不同组件、不同层级的超时必须分开配,否则 timeout 字段根本不起作用。
HTTP Server 的请求超时怎么配才生效
很多人以为在 Swoole\Http\Server 构造时传个 timeout 就行了,其实完全没用 —— 这个参数压根不被 HTTP Server 识别。真正起作用的是 setting 里的 request_timeout 和 heartbeat_idle_time。
-
request_timeout:控制单个 HTTP 请求从收到头开始到响应结束的总耗时,超时后连接会被强制关闭(返回 502) -
heartbeat_idle_time:只对长连接有效,指空闲多久断开,和业务逻辑超时不冲突 - 注意
request_timeout默认是 60 秒,但如果你用了协程客户端(比如Co\Http\Client)发下游请求,它的超时得单独设,不影响这里
new Swoole\Http\Server('0.0.0.0', 9501, SWOOLE_PROCESS);
$server->set([
'request_timeout' => 10, // ⚠️ 关键:这里才是 HTTP 请求级超时
]);
协程客户端(Co\Http\Client)超时必须显式指定
协程客户端默认不设超时,遇到下游卡住就会一直等,拖垮整个协程栈。它有三个独立超时参数,漏掉任何一个都可能出问题:
-
connect_timeout:建连阶段超时,DNS 解析 + TCP 握手 -
read_timeout:等待响应体数据的时间(含 header),不是整个请求耗时 -
write_timeout:发请求体的超时,POST 大包时容易触发 - 三者互不影响,比如
read_timeout到了会抛Swoole\Exception,但连接不一定关,下次复用可能出错
$client = new Co\Http\Client('api.example.com', 443, true);
$client->set([
'connect_timeout' => 3,
'read_timeout' => 5,
'write_timeout' => 3,
]);
Server::start() 后改 setting 不生效
所有超时相关配置必须在 $server->start() 之前调用 $server->set(),启动后再改等于白搭 —— Swoole 内部只在初始化时读一次 setting 数组。
- 常见错误:在
onStart或onWorkerStart里再调$server->set(),毫无效果 - 热更新配置?不行。只能重启进程,或改用
Server::reload()配合信号,但超时类 setting 不支持 reload 时重载 - 如果需要动态调优,建议把超时值抽成配置中心变量,在启动前拉取并写入
set()
WebSocket 场景下 ping/pong 超时容易误判
WebSocket 的心跳不是靠 request_timeout 控制的,而是由 heartbeat_check_interval 和 heartbeat_idle_time 共同决定。很多人把后者设太小,导致正常网络抖动就被踢掉。
-
heartbeat_idle_time是客户端最后一次发帧(包括 ping)到当前时间的空闲阈值 -
heartbeat_check_interval是服务端每多少秒扫一次过期连接,默认 30 秒,不能比heartbeat_idle_time小 - 例如设
heartbeat_idle_time=60却忘了调大heartbeat_check_interval,实际检测延迟可能高达 90 秒
$server->set([
'websocket_subprotocol' => '',
'heartbeat_idle_time' => 60,
'heartbeat_check_interval' => 25, // ⚠️ 必须小于 idle_time
]);
超时配置最麻烦的地方在于:每个组件只管自己那一层,上层不感知下层超时,下层也不反馈给上层。比如 Co\Http\Client 超时了,HTTP Server 的 request_timeout 还在继续倒计时 —— 两个计时器是并行的,得各自盯紧。










