本文详解如何在 PHP 中正确捕获 MySQL 查询超时异常（ERROR 3024），通过 mysqli_sql_exception 实现精准错误处理，并兼容不同 PHP 版本，确保超时逻辑健壮可靠。
本文详解如何在 php 中正确捕获 mysql 查询超时异常（error 3024），通过 `mysqli_sql_exception` 实现精准错误处理，并兼容不同 php 版本，确保超时逻辑健壮可靠。
MySQL 自 5.7.8 起支持语句级执行时间限制（MAX_EXECUTION_TIME），单位为毫秒（非秒），超时时会抛出标准 SQL 异常，错误码为 3024（HY000 类别），提示“Query execution was interrupted, maximum statement execution time exceeded”。在 PHP 中，需借助异常机制而非简单的返回值判断来可靠捕获该错误。
✅ 推荐做法：使用 try-catch 捕获 mysqli_sql_exception
自 PHP 8.1 起，mysqli 默认启用异常模式（MYSQLI_REPORT_STRICT），因此可直接使用 try...catch：
<?php $conn = mysqli_connect("localhost", "root", "password", "testdb");
// 设置当前会话的查询最大执行时间为 1000 毫秒（1 秒）
$conn->query('SET SESSION MAX_EXECUTION_TIME = 1000');
try {
// 故意构造一个超时查询（SLEEP(2) 阻塞 2 秒）
$results = $conn->query("SELECT COUNT(1) FROM information_schema.tables WHERE SLEEP(2) = 0");
// 查询成功：安全访问结果集
if ($results instanceof mysqli_result) {
$row = $results->fetch_row();
echo "Result: " . ($row[0] ?? 0);
}
} catch (mysqli_sql_exception $e) {
if ($e->getCode() == 3024) {
error_log("MySQL query timeout (3024): " . $e->getMessage());
echo "操作超时，请稍后重试";
} else {
// 非超时错误，建议重新抛出或记录完整上下文
error_log("MySQL error [" . $e->getCode() . "]: " . $e->getMessage());
throw $e; // 或返回通用错误响应
}
}
⚠️ 注意：$conn->query() 在超时发生时不会返回 false，而是直接抛出异常；因此不能依赖 if ($results === false) 判断——该方式会跳过异常，导致超时被静默忽略。
? 兼容旧版 PHP（
若运行 PHP 7.x 或早期 8.0 版本，需显式启用严格异常模式，否则 mysqli 默认仅返回 false，不抛异常：
// 必须在创建连接前调用（或至少在 query 前启用）
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$conn = mysqli_connect("localhost", "user", "pass", "db");
$conn->query('SET SESSION MAX_EXECUTION_TIME = 1000');
try {
$results = $conn->query("SELECT ...");
// 处理结果
} catch (mysqli_sql_exception $e) {
if ($e->getCode() === 3024) {
// 超时专用处理逻辑
http_response_code(408); // 可选：返回 HTTP 408 Request Timeout
echo json_encode(['error' => '请求处理超时']);
} else {
throw $e;
}
}
? 关键注意事项
- 单位陷阱：MAX_EXECUTION_TIME 参数单位是毫秒（如 1000 = 1 秒），不是秒；
- 作用域限制：SET SESSION MAX_EXECUTION_TIME 仅对后续单条查询生效，不会影响已开始的查询；
-
替代方案：也可在 SQL 中内联 hint（推荐用于动态控制）：
SELECT /*+ MAX_EXECUTION_TIME(500) */ id FROM users WHERE ...
- 连接池/长连接场景：超时设置属于会话级，每次新连接需重新设置；
- 错误码可靠性：MySQL 官方文档明确将 3024 定义为超时专属错误码，可安全用于分支判断（无需正则匹配错误消息）。
通过以上方式，您不仅能准确识别超时，还能保持代码清晰、错误可追溯，并为用户提供友好的降级体验。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
