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）超时必须显式指定
协程客户端默认不设超时，遇到下游卡住就会一直等，拖垮整个协程栈。它有三个独立超时参数，漏掉任何一个都可能出问题：
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
-
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 还在继续倒计时 —— 两个计时器是并行的，得各自盯紧。
