本文介绍在 PHP 中通过 MySQL 会话变量 MAX_EXECUTION_TIME 为 SELECT 查询设置执行超时的正确方法，解决长时间全表扫描导致响应阻塞的问题。
本文介绍在 php 中通过 mysql 会话变量 `max_execution_time` 为 select 查询设置执行超时的正确方法，解决长时间全表扫描导致响应阻塞的问题。
在 PHP 应用中，当用户输入模糊搜索条件（如未加索引字段的 LIKE '%keyword%'）时，MySQL 可能触发全表扫描，导致查询耗时数秒甚至更久，严重影响用户体验与服务可用性。虽然 MYSQLI_OPT_CONNECT_TIMEOUT 仅控制连接建立阶段的超时，而 max_statement_time（无 SESSION 修饰）并非标准 MySQL 变量名——真正生效的是 SET SESSION MAX_EXECUTION_TIME = N（单位：毫秒），且需在连接建立后、查询执行前显式设置。
✅ 正确做法如下：
<?php
$conn = mysqli_connect("localhost", "username", "password", "database");
if (!$conn) {
die("Connection failed: " . mysqli_connect_error());
}
// ✅ 关键：设置当前会话的语句执行超时（单位：毫秒）
// 例如：3000 毫秒 = 3 秒
$conn->query('SET SESSION MAX_EXECUTION_TIME = 3000');
// 后续所有 SELECT 查询将受此限制
$result = $conn->query("SELECT COUNT(1) FROM `table` WHERE name LIKE '%abc%'");
if (!$result) {
// 超时时 MySQL 返回错误码 3024（ER_QUERY_TIMEOUT）
if ($conn->errno == 3024) {
echo "Query timed out after 3 seconds.";
} else {
echo "Query error: " . $conn->error;
}
} else {
$count = $result->fetch_row()[0];
echo "Found $count records.";
}
?>⚠️ 注意事项：
kashen-mysql DDLtoExcel
下载
解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
- MAX_EXECUTION_TIME 是 MySQL 5.7.4+ 引入的特性，低版本不支持（启用前请执行 SELECT VERSION() 确认）；
- 该设置仅对当前会话生效，不影响其他连接；
- 它作用于单条 SQL 语句的执行阶段（即 optimizer + execution），不包含网络传输或客户端处理时间；
- 不可与 SQL_TSI_* 或 SQL_TIMEOUT= 等非标准语法混用（后者无效）；
- 若使用 PDO，可通过 PDO::exec('SET SESSION MAX_EXECUTION_TIME = 3000') 实现等效配置；
- 建议配合慢查询日志（slow_query_log=ON, long_query_time=1）与索引优化，从根本上减少超时风险。
? 总结：SET SESSION MAX_EXECUTION_TIME 是最轻量、最直接的查询级超时控制方案。它无需修改 PHP 连接参数或引入第三方库，只需一行语句即可为高风险查询加上“安全熔断”，是构建健壮 Web 服务的重要实践。
立即学习“PHP免费学习笔记（深入）”；
