连接池超限的典型表现是日志出现“sql: connection limit exceeded”或dns解析失败，监控显示sql_open_connections打满、sql_idle_connections趋零；根本原因是setmaxopenconns设置过高或未调用rows.close()/tx.commit()导致连接泄漏。
连接池超限的典型表现和根本原因
服务日志里频繁出现 sql: connection limit exceeded 或 dial tcp: lookup xxx: no such host，Prometheus 监控显示 sql_open_connections 持续打满、sql_idle_connections 接近零——这不是数据库扛不住，而是 Go 应用自己把连接池“撑爆”了。
根本原因就两个：一是 SetMaxOpenConns 设得比数据库 max_connections 还高，二是代码里漏掉 rows.Close() 或 tx.Commit()/Rollback()，导致连接永远不归还池子。
- MySQL 默认
max_connections=151，但很多 Go 项目直接设db.SetMaxOpenConns(0)（无限制）或200，一上线就触发数据库拒绝新连接 -
database/sql不会自动关闭*sql.Rows，必须显式调用rows.Close()；事务也必须配对Commit()/Rollback()，否则连接卡在“in use”状态 - 连接泄漏常藏在 defer 里：比如
defer rows.Close()写在循环体外，或错误分支没覆盖
三个关键参数怎么设才不踩坑
别照抄网上示例值。每个参数都要和你的部署环境、数据库配置、QPS 匹配。
-
SetMaxOpenConns(n)：必须 ≤ 数据库max_connections×（Pod 数量 / 副本数）。例如 MySQLmax_connections=200，K8s 部署 3 个 Pod，则单 Pod 最多设66，留点余量建议50 -
SetMaxIdleConns(m)：设为SetMaxOpenConns的 1/3～1/2。太小（如默认2）会导致高峰期频繁建连；太大（如等于MaxOpen）浪费空闲连接 -
SetConnMaxLifetime(d)：设为略小于数据库的wait_timeout（MySQL 默认 8 小时）。推荐1h～3h，避免连接被 DB 主动 kill 后 Go 端还尝试复用
错误示范：db.SetMaxOpenConns(100); db.SetMaxIdleConns(100) —— Idle 和 Open 一样大，等于放弃连接复用策略，所有连接都长期驻留。
如何快速定位连接泄漏
光看代码 review 很难发现漏关的地方。要用数据说话。
- 加一行监控：在初始化
*sql.DB后，定期打点db.Stats()，暴露OpenConnections、IdleConnections、InUse三个指标到 Prometheus - 压测时观察曲线：如果
InUse持续上涨不回落，基本确认泄漏；再结合 pprof heap 查*sql.conn对象数量是否随请求线性增长 - 加日志钩子：重写
driver.Conn的Close()方法（需包装底层 driver），记录每次 Close 调用来源，定位没释放的 goroutine
注意：db.Close() 是关整个池，不是释放单个连接，别在 handler 里调它。
gRPC 或 HTTP 客户端连接池也要同样对待
很多人只调数据库池，忘了下游调用的连接池。gRPC 的 grpc.Dial、HTTP 的 http.DefaultClient 都有内置连接池，不调优照样超限。
- gRPC：用
grpc.WithTransportCredentials+grpc.WithKeepaliveParams控制长连接复用，配合grpc.WithBlock()避免 Dial 阻塞；连接数上限靠grpc.WithConnectParams中的MinConnectTimeout和重试逻辑间接控制 - HTTP：替换
http.DefaultClient，自定义http.Transport，重点设MaxIdleConns、MaxIdleConnsPerHost、IdleConnTimeout—— 这三个不设，默认是100、2、30s，极易打满文件描述符 - 共通陷阱：多个微服务共用一个全局 client 实例没问题，但千万别在 handler 里 new 一堆 client，每个都带独立连接池
最易忽略的是：数据库池和 HTTP/gRPC 池的资源消耗叠加后，可能先耗尽系统级 fd（ulimit -n），而不是某个具体池的上限。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
