Hyperf 中 MySQL 超时需分层配置：服务端设 wait_timeout/interactive_timeout 控制空闲连接；应用层用 MAX_EXECUTION_TIME 提示或 DSN 参数（connect_timeout/read_timeout）控制 SQL 执行；事务级靠 innodb_lock_wait_timeout；连接池通过 pool.connect_timeout 控制获取连接超时。
Hyperf 本身不直接设置 MySQL 的超时时间，它依赖底层 MySQL 服务端配置和应用层（如连接池、SQL 执行）的协同控制。超时涉及多个层级，需分场景明确设置位置：
MySQL 服务端连接空闲超时（最常用）
控制连接建立后无操作多久被断开，防止连接堆积：
- 修改
wait_timeout和interactive_timeout参数 - 临时生效（仅新连接）：
SET GLOBAL wait_timeout = 600; SET GLOBAL interactive_timeout = 600;
- 永久生效：在
/etc/my.cnf或/etc/mysql/mysql.conf.d/mysqld.cnf的[mysqld]段添加：wait_timeout = 600 interactive_timeout = 600
- 重启 MySQL：
sudo systemctl restart mysql
Hyperf 应用层 SQL 执行超时（单条查询）
Hyperf 的 DB 组件不内置全局 query timeout，但可通过以下方式控制：
-
使用 MySQL 8+ 的执行时间提示（推荐，精准到语句）：
DB::select('SELECT /*+ MAX_EXECUTION_TIME(3000) */ * FROM users');注意：
/*+格式必须带加号，单位毫秒，仅对当前语句生效
MySQL8 CRM Schema Design Expert下载面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
-
在连接池配置中指定 JDBC/PHP 风格的 socket timeout（若使用 PDO + 自定义 DSN）：
在config/autoload/database.php的mysql配置里，options中追加 PDO 属性（部分驱动支持）：'options' => [ \PDO::ATTR_TIMEOUT => 3, // 连接级等待，非标准，依驱动而定 ],更可靠的方式是结合数据库连接 URL 参数（如 MySQLi 或 PDO_MYSQL 支持
connect_timeout、read_timeout）：'uri' => 'mysql:host=127.0.0.1;port=3306;dbname=test;charset=utf8mb4;connect_timeout=5;read_timeout=30',
事务级超时（Hyperf + MySQL 协同）
MySQL 无原生事务总耗时限制，但可间接控制：
- 设置
innodb_lock_wait_timeout（锁等待超时，默认 50 秒）：SET GLOBAL innodb_lock_wait_timeout = 20;
- Hyperf 中配合
@Transactional注解（需集成 Hyperf/Transaction）或手动控制事务范围，避免长事务 - 定期查
information_schema.innodb_trx监控运行过久的事务
连接池获取连接超时（Hyperf 内部）
由 Hyperf 的 hyperf/db 和连接池组件控制：
- 在
config/autoload/database.php中调整：'pool' => [ 'min_connections' => 1, 'max_connections' => 32, 'connect_timeout' => 5.0, // 获取连接最大等待秒数（关键！） 'wait_timeout' => 3.0, // 等待空闲连接超时（秒） 'heartbeat' => -1, ],connect_timeout是从连接池拿到可用连接的上限时间，超时抛ConnectionException
基本上就这些。核心是分清「连接建立超时」「连接空闲超时」「SQL 执行超时」「锁等待超时」——每种对应不同配置点，不能只改一处。
