Skip to content

查询超时:语句执行时间过长

快速摘要

你的查询运行时间超过了配置的超时 —— 数据库取消了它并返回超时错误。

为什么发生

  • 查询在没有适当索引的大表上扫描,导致缓慢的全表扫描

  • 语句超时设置对于合法的长时间运行分析查询来说太低

  • 缺少 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 子句、限制结果或重写连接来优化查询

如何预防

  • 在频繁查询的列上创建索引并监控慢查询日志

  • 设置适当的语句超时并对大结果集使用分页

相关资源

相关术语

相关课程

← 返回语言