Hyperf3.2 read_timeout怎么配置避免慢查询卡死-php教程-PHP中文网

Hyperf 3.2 中 read_timeout 非全局配置，需按组件分别设置：Guzzle 用 options.timeout（等效 read_timeout），Redis 在 redis.php 中配 read_timeout，MySQL 在 DSN 中加 read_timeout=3，还需协程级 timeout 兜底防卡死。

hyperf3.2 read_timeout怎么配置避免慢查询卡死

Hyperf 3.2 中的 read_timeout 不是框架层统一配置项，而是分组件生效的底层连接参数。它主要作用于 HTTP 客户端（如 Guzzle）、Redis、数据库连接等 I/O 操作，目的是防止因远端响应慢或网络异常导致协程长时间阻塞。卡死往往不是因为没设 timeout，而是设错位置或值不合理。

HTTP 客户端的 read_timeout 配置

Hyperf 默认使用 hyperf/guzzle，超时由 Guzzle 的 timeout 和 connect_timeout 控制，其中 timeout 等效于 read_timeout（即从连接建立后开始计时的总等待时间）。

在 config/autoload/clients.php 中配置：

php

'guzzle' => [
    'handler' => \Hyperf\Guzzle\HandlerStackFactory::class,
    'options' => [
        'timeout' => 5.0,         // ⚠️ 关键：等效 read_timeout，单位秒，建议 3–10
        'connect_timeout' => 3.0, // 连接建立阶段超时
        'http_errors' => false,   // 避免 4xx/5xx 直接抛异常中断流程
    ],
],

调用时也可动态覆盖：$client->get($url, ['timeout' => 2.5])
注意：设为 0 或 false 表示无限等待，生产环境严禁

Redis 的 read_timeout 设置

Hyperf 使用 Swoole\Coroutine\Redis，其 read_timeout 是连接级参数，需在 Redis 配置中显式指定：

hyperframes-超帧视频

HTML 驱动的视频合成——GSAP 动画、TTS 字幕、音频响应、着色器转场

下载

修改 config/autoload/redis.php：

php

'default' => [
    'host' => env('REDIS_HOST', 'localhost'),
    'auth' => env('REDIS_AUTH', null),
    'port' => (int) env('REDIS_PORT', 6379),
    'db' => (int) env('REDIS_DB', 0),
    'read_timeout' => 3.0, // ✅ 显式设置，单位秒，推荐 2–5
    'write_timeout' => 3.0,
    'timeout' => 3.0,       // 向后兼容旧版写法（部分版本仍识别）
],

该参数直接影响 get、hGetAll 等命令——大 key 或高延迟 Redis 实例下不设会卡住整个协程
若使用 Redis Cluster，每个节点连接都需单独配置 read_timeout

数据库连接的 read_timeout（MySQL / PostgreSQL）

Hyperf 的 hyperf/db 基于 PDO，不直接暴露 read_timeout，但可通过 PDO DSN 参数注入：

在 config/autoload/databases.php 的 DSN 中添加 read_timeout=3：

php

'mysql' => [
    'driver' => env('DB_DRIVER', 'mysql'),
    'host' => env('DB_HOST', 'localhost'),
    'port' => env('DB_PORT', 3306),
    'database' => env('DB_DATABASE', 'hyperf'),
    'username' => env('DB_USERNAME', 'root'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => env('DB_CHARSET', 'utf8mb4'),
    'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),
    'prefix' => env('DB_PREFIX', ''),
    'strict' => true,
    'options' => [
        PDO::ATTR_CASE => PDO::CASE_NATURAL,
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        PDO::ATTR_EMULATE_PREPARES => false,
    ],
    'dsn' => env('DB_DSN', 'mysql:host=localhost;port=3306;dbname=hyperf;charset=utf8mb4;read_timeout=3'), // ✅ 加在这里
],

MySQL 服务端也需开启 wait_timeout 和 interactive_timeout 配合（建议设为 300 秒以上）
PostgreSQL 可用 options='--client-min-messages=warning -c statement_timeout=3000' 控制语句级超时

全局协程超时兜底（防漏网之鱼）

即使各组件设了 timeout，业务逻辑中手动 sleep、密集计算或未封装的第三方 SDK 仍可能卡住。推荐加一层协程级保护：

在关键异步任务外包裹 timeout：

php

use Hyperf\Coroutine\Coroutine;

$result = Coroutine::timeout(8.0, function () {
    return $this->heavyService->process();
});

if ($result === false) {
    throw new \RuntimeException('Operation timed out');
}