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');

  注意：/*+ 格式必须带加号，单位毫秒，仅对当前语句生效

• 在连接池配置中指定 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）：

  

  MySQL8 CRM Schema Design Expert

  面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。

  下载

  '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 执行超时」「锁等待超时」——每种对应不同配置点，不能只改一处。