context.withtimeout不能控制sql.db连接池生命周期，仅影响单次查询、连接获取或健康检查的超时；连接池需通过setmaxopenconns等参数配置，db.close()仅在应用退出或动态创建后不再使用时调用。
context.WithTimeout 不能直接控制 sql.DB 连接池生命周期
很多人误以为给 sql.Open 或查询操作传入带超时的 context，就能让连接池自动关闭或回收连接。实际上，sql.DB 的连接池本身是长期存活的，不受单次 context 生命周期影响；context 只能控制**单次查询、执行或连接建立过程**是否超时或被取消。
真正需要 context 干预的环节是：
- 调用
db.Conn(ctx)获取底层连接时（可能阻塞在等待空闲连接） - 执行
conn.QueryContext、stmt.ExecContext等带 context 的方法 - 调用
db.PingContext做健康检查时
用 context 控制连接获取与查询的超时行为
连接池空闲连接耗尽时，db.Query 会阻塞等待，直到有连接释放或超时。这时必须用带 context 的方法才能设置等待上限。
示例场景：限制“最多等 2 秒拿到连接并完成查询”：
ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()
<p>rows, err := db.QueryContext(ctx, "SELECT name FROM users WHERE id = ?", userID)
if err != nil {
// 可能是 context.DeadlineExceeded（等连接超时），也可能是 SQL 执行失败
if errors.Is(err, context.DeadlineExceeded) {
log.Println("timeout while waiting for connection or executing query")
}
return err
}
defer rows.Close()
</p>
注意点：
-
QueryContext超时后，底层连接**不会被销毁**，只是本次请求放弃，连接仍归还池中 - 如果想强制中断正在执行的 SQL（如慢查询），需数据库支持 cancel（如 PostgreSQL 的
pgconn+CancelRequest），MySQL 原生驱动不支持 true query cancellation - 避免对每个查询都新建 long-lived context；高频场景建议复用带合理 timeout 的 context，或用
context.WithDeadline绑定业务截止时间
连接池参数配置比 context 更影响实际并发表现
context 超时只是“兜底”，真正决定能否扛住并发、是否频繁卡住的，是 sql.DB 的连接池配置。这些参数必须在 sql.Open 后立即设置：
db, _ := sql.Open("mysql", dsn)
db.SetMaxOpenConns(20) // 同时打开的最大连接数（含正在用+空闲）
db.SetMaxIdleConns(10) // 空闲连接最大数量
db.SetConnMaxLifetime(60 * time.Second) // 连接最长复用时间（防 stale connection）
db.SetConnMaxIdleTime(30 * time.Second) // 空闲连接最长保留时间
常见误区：
-
SetMaxOpenConns(0)表示无限制 → 实际会触发操作系统级文件描述符耗尽，服务崩溃 - 不设
SetConnMaxIdleTime→ 空闲连接永久滞留，可能因网络中断或 DB 重启变成僵尸连接 - 把
SetConnMaxLifetime设太短（如 1s）→ 频繁新建/销毁连接，CPU 和 TLS 开销陡增
何时该显式关闭 db？哪些 context 场景需要 defer db.Close()
sql.DB 不是连接，而是连接池管理器；它本身不需要也不应该在每次请求后 Close()。但以下两种情况必须调用 db.Close()：
- 应用退出前（如
main函数结束、HTTP server shutdown 阶段）—— 否则进程退出时未释放的连接可能导致 DB 端连接堆积 - 动态创建多个
sql.DB实例且明确不再使用（如多租户场景按 tenant 初始化独立 db）
此时可结合 context 确保优雅关闭：
// 在 server.Shutdown 中使用
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
if err := db.Close(); err != nil {
// Close() 本身不接受 context，但可在超时后强行返回
select {
case <p>关键提醒：没有“context-aware 的 db.Close”；<code>db.Close()</code> 会等待所有正在使用的连接归还后再返回，因此务必确保上游已停止发请求，否则可能无限期阻塞。</p>
