查询超时:语句执行时间过长
快速摘要
你的查询运行时间超过了配置的超时 —— 数据库取消了它并返回超时错误。
为什么发生
查询在没有适当索引的大表上扫描,导致缓慢的全表扫描
语句超时设置对于合法的长时间运行分析查询来说太低
缺少 WHERE 子句或过于宽泛的过滤器返回了远超预期的行数
最小示例
✗ 错误代码
const result = await db.query('SELECT * FROM orders JOIN items ON orders.id = items.order_id');
// No WHERE clause, no index on items.order_id — full scan, times out✓ 修复代码
// Add index: CREATE INDEX idx_items_order_id ON items(order_id);
const result = await db.query(
'SELECT * FROM orders JOIN items ON orders.id = items.order_id WHERE orders.date >= $1 LIMIT 100',
['2024-01-01']
);在连接列上添加索引并使用带 LIMIT 的 WHERE 子句缩小查询范围,使其在超时时间内完成。
如何诊断
对查询运行 EXPLAIN ANALYZE 以识别慢操作(顺序扫描、嵌套循环等)
检查 WHERE、JOIN 和 ORDER BY 子句中使用的列是否存在适当的索引
查看语句超时设置并与预期查询持续时间比较
如何修复
在频繁过滤的列上添加索引以加速查询
对于已知长时间运行的分析查询增大语句超时
通过添加 WHERE 子句、限制结果或重写连接来优化查询
如何预防
在频繁查询的列上创建索引并监控慢查询日志
设置适当的语句超时并对大结果集使用分页