PHP中设置MySQL SELECT查询超时并处理错误的方法

首先说明你之前尝试的方案不生效的核心原因：

• MYSQLI_OPT_CONNECT_TIMEOUT、连接参数里的connect_timeout 仅控制数据库连接建立阶段的超时时间，对连接成功之后的查询执行耗时完全无效
• MAX_EXECUTION_TIME 优化器hint的单位是毫秒，且仅支持MySQL 5.7及以上版本的InnoDB只读查询，版本不匹配、存在锁等待、使用其他存储引擎时都会失效
• SQL_TIMEOUT 不属于MySQL原生支持的语法，是无效语句
• max_statement_time 是MariaDB/Percona分支的变量，原生MySQL对应的变量名是max_execution_time（单位毫秒），变量名、单位写错都会导致设置不生效。

推荐方案1：SQL层设置（改动最小，优先使用） #

根据你用的数据库类型选择对应写法即可：

原生MySQL 5.7+ 环境 #

两种写法二选一即可：

1. 会话级全局设置：对当前连接下所有后续SELECT生效

<?php
$conn = mysqli_connect("localhost", "user", "pass", "db");
// 设置当前会话查询超时为1秒，注意单位是毫秒，1秒=1000毫秒
$conn->query('SET SESSION max_execution_time = 1000');

2. 单查询hint设置：仅对当前这一条SQL生效，灵活性最高，不会影响同连接其他查询

// 注意hint里的时间单位同样是毫秒
$sql = 'SELECT /*+ MAX_EXECUTION_TIME(1000) */ COUNT(1) FROM `table` WHERE ...';
$result = $conn->query($sql);

超时触发后查询会直接返回false，捕获对应错误即可做业务处理：

if (!$result) {
    // 超时错误信息会包含max_execution_time关键字
    if (str_contains($conn->error, 'max_execution_time')) {
        // 这里写超时后的业务逻辑，比如提示用户细化搜索条件
        echo "查询耗时过长，请缩小搜索范围后重试";
    }
}

MariaDB/Percona Server 环境 #

把变量名换成max_statement_time即可，单位为秒：

$conn->query('SET SESSION max_statement_time = 1');

注意：SQL层超时仅统计查询执行的耗时，不包含结果集回传至PHP的时间，如果查询返回的结果集体量极大，传输产生的额外耗时不会被计入超时。

推荐方案2：PHP侧异步轮询超时（全版本兼容） #

如果你的MySQL版本低于5.7，不支持上述SQL层面的超时参数，可以用mysqli异步查询实现全版本兼容的超时控制，不依赖数据库配置：

<?php
$conn = mysqli_connect("localhost", "user", "pass", "db");
$timeout = 1; // 定义超时时间，单位秒
// 以异步模式发起查询，不阻塞PHP进程
$conn->query('SELECT COUNT(1) FROM `table` WHERE ...', MYSQLI_ASYNC);
$startTime = microtime(true);
do {
    $queryResult = mysqli_reap_async_query($conn);
    // 判断是否已经超过设定的超时时间
    if (microtime(true) - $startTime > $timeout) {
        // 超时后主动终止当前正在执行的查询
        $conn->kill($conn->thread_id);
        echo "查询耗时过长，请缩小搜索范围后重试";
        exit;
    }
    // 轮询间隔10毫秒，避免CPU占用过高
    usleep(10000);
} while (!$queryResult);
// 查询正常执行完成，后续正常处理结果集即可
$result = $queryResult;

这个方案不受数据库版本、存储引擎、查询类型限制，无论是全表扫描还是锁等待，到设定时间都会主动中止查询，符合模糊搜索时自动终止慢查询的需求。

内容的提问来源于stack exchange，提问作者Ned Hulton