SQL查询超时通常是由于查询执行时间过长，超过了数据库或应用层设置的等待阈值导致的，设置合理的执行超时限制可以在查询异常耗时的时候及时中断，避免资源被长时间占用。除了设置超时，还需要结合查询优化来从根源上减少超时出现的概率。
SQL查询超时的常见原因
在设置超时限制之前，先了解查询超时的常见诱因，能帮助我们更合理地设置超时阈值：
- 查询语句没有走索引，全表扫描大量数据
- 查询关联了多张大表，没有优化关联条件
- 数据库服务器资源不足，CPU或内存占用过高
- 查询返回的数据量过大，网络传输耗时过长
- 存在锁等待情况，查询被其他事务阻塞
不同场景下的SQL执行超时设置方法
1. 数据库层面设置超时
MySQL设置语句执行超时
MySQL可以通过max_execution_time参数设置单条查询的最大执行时间，单位是毫秒，也可以在会话级别单独设置：
-- 全局设置所有查询的最大执行时间为30秒（30000毫秒） SET GLOBAL max_execution_time = 30000; -- 当前会话设置查询最大执行时间为10秒 SET SESSION max_execution_time = 10000; -- 单条查询单独设置超时时间，单位毫秒 SELECT /*+ MAX_EXECUTION_TIME(5000) */ * FROM user_table WHERE age > 18;
PostgreSQL设置语句执行超时
PostgreSQL可以通过statement_timeout参数设置，单位是毫秒，支持会话级和事务级设置：
-- 当前会话设置查询超时为20秒 SET statement_timeout = 20000; -- 事务内设置超时，事务结束后失效 BEGIN; SET LOCAL statement_timeout = 10000; SELECT * FROM order_table WHERE create_time > '2024-01-01'; COMMIT;
SQL Server设置查询超时
SQL Server可以通过SET LOCK_TIMEOUT设置锁等待超时，也可以通过连接属性设置查询执行超时：
-- 设置锁等待超时时间为30秒，0表示不等待立即返回错误 SET LOCK_TIMEOUT 30000; -- 设置当前连接的查询执行超时为60秒（需要在连接建立时配置，部分客户端支持） -- 例如ADO.NET中设置CommandTimeout属性为60
2. 应用层设置SQL执行超时
除了数据库层面，应用层也可以设置超时，避免应用长时间等待数据库响应：
Java JDBC设置查询超时
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
public class SqlTimeoutDemo {
public static void main(String[] args) throws Exception {
Connection conn = DriverManager.getConnection("jdbc:mysql://127.0.0.1:3306/test_db", "root", "password");
PreparedStatement ps = conn.prepareStatement("SELECT * FROM big_table WHERE status = ?");
// 设置查询超时为15秒，单位秒
ps.setQueryTimeout(15);
ps.setInt(1, 1);
ResultSet rs = ps.executeQuery();
while (rs.next()) {
System.out.println(rs.getString("name"));
}
rs.close();
ps.close();
conn.close();
}
}
Python pymysql设置查询超时
import pymysql
# 建立连接时设置查询超时为20秒，单位秒
conn = pymysql.connect(
host='127.0.0.1',
port=3306,
user='root',
password='password',
database='test_db',
connect_timeout=20,
read_timeout=20
)
cursor = conn.cursor()
# 执行查询，超过20秒会抛出异常
cursor.execute("SELECT * FROM user_table WHERE id > 1000")
result = cursor.fetchall()
cursor.close()
conn.close()
设置超时的注意事项
- 超时阈值不要设置过短，避免正常的大查询被误中断，建议根据业务查询的平均耗时和最大合理耗时来设置
- 超时设置只是兜底方案，核心还是优化查询语句和数据库结构，比如添加合适索引、拆分大查询、避免返回不必要的数据
- 超时后要做好异常处理，记录超时日志，方便后续排查具体的慢查询问题
- 不同数据库的超时参数作用范围不同，设置前需要确认参数的生效范围，避免影响其他正常业务
超时后的排查思路
如果频繁出现查询超时，不要只调整超时阈值，需要按照以下步骤排查：
- 查看数据库慢查询日志，找到超时的具体SQL语句
- 分析SQL的执行计划，查看是否走了索引，是否存在全表扫描
- 检查数据库服务器的资源使用情况，是否存在CPU、内存、磁盘IO瓶颈
- 查看是否有长事务未提交，导致查询被锁阻塞
- 如果是返回数据量过大，考虑分页查询或者只返回需要的字段
需要注意的是，设置超时限制只是应对查询超时的一种防护手段，不能替代查询优化工作。合理的超时设置配合持续的查询性能优化，才能从根本上减少SQL查询超时的发生。