context.WithTimeout 配合 QueryContext/ExecContext 是控制 SQL 查询执行时间最可靠的方式，因 database/sql 本身不支持查询级超时，驱动层 timeout 参数仅作用于连接建立与读写首字节，无法中断已执行的慢查询。
context.WithTimeout 控制 query 执行时间最可靠
Go 的 database/sql 本身不提供“查询级超时”，只支持连接池层面的 SetConnMaxLifetime 或驱动层的连接超时（如 MySQL 的 timeout 参数），但这些对单条慢查询无效。真正能中断正在执行的 SQL 查询的，只有 context.WithTimeout 配合支持 context 的查询方法（如 QueryContext、ExecContext）。
注意：不是所有驱动都完整实现 context 取消逻辑。比如老版本 mysql 驱动（go-sql-driver/mysql v1.6.0 之前）在已发送 SQL 到服务端后，收到 cancel 信号不会主动 kill 连接上的语句，只能等服务端自己超时或客户端断连。v1.7.0+ 已修复，但需确认你用的版本。
- 必须用
QueryContext/ExecContext等带 context 的方法，不能用Query/Exec - context 超时时间应略大于预期最大响应时间（比如设 3s，而不是刚好卡在 2s）
- MySQL 服务端也建议配
max_execution_time（5.7.8+），作为兜底：例如在 DSN 中加&maxExecutionTime=3000（单位毫秒）
MySQL 驱动里 timeout 参数只管连接建立，不管 SQL 执行
常见误区是往 DSN 里塞 timeout=3s 或 readTimeout=3s，比如：user:pass@tcp(127.0.0.1:3306)/db?timeout=3s&readTimeout=3s。这些参数只控制 TCP 连接建立、TLS 握手、以及从 socket 读取第一个字节的时间，一旦 SQL 发出去、服务端开始执行，它们就完全失效了。
更隐蔽的问题是：如果服务端返回结果途中网络卡住（比如大结果集传输一半断连），readTimeout 才会起作用——但它无法阻止服务端内部的慢查询。
立即学习“go语言免费学习笔记（深入）”；
-
timeout：连接建立总耗时上限 -
readTimeout：每次 read() 系统调用等待数据的上限（非整个查询） -
writeTimeout：写 SQL 到 socket 的单次上限（一般极短，很少触发） - 以上三个参数都不等于“SQL 执行超时”
超时后记得检查 err 是否为 context.Canceled
调用 QueryContext 后如果超时，返回的 err 通常是 context.DeadlineExceeded（底层是 context.Canceled 的变体），但不是所有驱动都严格返回这个值。有些旧驱动可能返回 driver.ErrBadConn 或直接 panic，所以不能只靠 error 字符串判断。
正确做法是用 errors.Is(err, context.DeadlineExceeded) 或 errors.Is(err, context.Canceled) 做判定，避免误把其他错误当超时处理。
- 别用
strings.Contains(err.Error(), "timeout")—— 不稳定且易漏 - 超时错误发生后，对应连接可能被标记为 bad，下一次复用会自动重连（
database/sql内置行为） - 不要在超时后继续调用
rows.Close()—— 如果rows是 nil，会 panic；应先判空
长事务 or 大结果集场景下，超时未必能立刻释放资源
即使用了 context.WithTimeout 并成功返回错误，MySQL 服务端那条 SQL 可能仍在运行。Go 客户端断开连接后，服务端会感知到 client gone，但清理动作（比如回滚事务、释放锁、清理临时表）需要时间，尤其在没开 innodb_rollback_on_timeout 或事务嵌套深的情况下。
这意味着：前端看到“查询超时”，DBA 却在 SHOW PROCESSLIST 里看到同一条语句还在 Query 状态。这不是 Go 代码写错了，而是协议和数据库行为本身的限制。
- 线上务必开启
wait_timeout和interactive_timeout（建议 300s），防止僵尸连接堆积 - 对可能长时间运行的查询（如报表导出），考虑改用异步任务 + 状态轮询，而非同步 HTTP 请求扛住整个执行周期
- 监控维度要同时看应用层 context 超时次数 + DB 层
Aborted_clients/Slow_queries
