Workerman4 异步 HttpClient 超时设置，网络异常请求卡死防护-php教程-PHP中文网

workerman 4 不支持原生协程异步 http 客户端，需用 curl 同步调用并严格设置 connect_timeout_ms、timeout_ms、low_speed_limit 与 low_speed_time 等超时参数防卡死，且无法使用 await 或 workerman/http-client v2+。

workerman4 异步 httpclient 超时设置，网络异常请求卡死防护

Workerman 4 并不原生支持真正的协程异步 HTTP 客户端。它依赖同步阻塞式扩展（如 cURL）或第三方库模拟异步，无法像 Workerman 5 那样基于 revolt/event-loop 和 PHP fibers 实现非阻塞 I/O。因此，在 Workerman 4 中做“异步 HttpClient 超时设置”，本质是规避同步调用卡死，而非精细控制协程阶段超时。

明确限制：Workerman 4 没有内置 awaitable HTTP 客户端

官方 workerman/http-client 组件从 v2.0 起仅兼容 Workerman ≥ 5.0；Workerman 4 用户若强行引入，会因缺少 fiber 支持而直接报错（如 Fiber not running 或未定义 Revolt 函数）。所以不能使用 await $client->get() 这类写法。

常见误用包括：

试图在 onMessage 中 await 任意 HTTP 调用 —— 会立即崩溃或静默失败
把 file_get_contents 或 curl_exec 包装成“异步”函数 —— 实际仍是同步阻塞，主线程卡住
未设超时就调用 curl_exec —— 默认无限等待，一个慢请求拖垮整个进程

Workerman 4 可行方案：cURL 同步调用 + 强制超时

必须用 curl_setopt 显式设置全部关键超时参数，且需组合使用才能防卡死：

Aiva.ai

Aiva.ai是一款用于生成多风格原创曲目的 AI 音乐作曲助手。

下载

connect_timeout：建立 TCP 连接最长等待时间（建议 ≤ 3 秒）
timeout：整个请求最大耗时（含连接、发送、接收），应略大于预期响应时间（建议 ≤ 8 秒）
low_speed_limit + low_speed_time：防止服务器已连接但传输极慢（如卡在流式响应开头）

示例代码：

（注意：必须在每次请求前重置 cURL 句柄，不可复用）

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT_MS, 3000); // 连接超时 3s
curl_setopt($ch, CURLOPT_TIMEOUT_MS, 8000);        // 总超时 8s
curl_setopt($ch, CURLOPT_LOW_SPEED_LIMIT, 1);      // 速度低于 1B/s
curl_setopt($ch, CURLOPT_LOW_SPEED_TIME, 5);       // 持续 5s 则中断
$response = curl_exec($ch);
$err = curl_error($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($response === false || $err) {
    error_log("cURL failed: $err (code: " . curl_errno($ch) . ")");
    return ['error' => 'network_unavailable'];
}

网络异常兜底：心跳 + 进程级防护

单靠 cURL 超时不足够。Workerman 4 的事件循环本身无协程调度能力，一旦某个连接因内核问题僵死（如 FIN_WAIT2 卡住），cURL 可能仍不返回。需叠加两层防护：

Worker 进程自动重启：在 start.php 中设置 $worker->reloadable = true;，并配合主进程对长时间无响应工作进程的 kill 与拉起
TCP 层保活：在 socket 连接上启用 TCP_KEEPALIVE（需底层支持），减少僵死连接残留
客户端心跳检测：若对接的是 WebSocket 服务，可参考 Workerman 4 的 $ws_worker->ping_interval = 25; 配置，主动探测连接活性