Go 应用连接 PostgreSQL 时出现 “sorry, too many clients already” 错误，本质是数据库连接数耗尽；根本原因并非未关闭 rows，而是未合理配置 *sql.DB 的连接池参数，导致连接泄漏或堆积。
go 应用连接 postgresql 时出现 “sorry, too many clients already” 错误，本质是数据库连接数耗尽；根本原因并非未关闭 rows，而是未合理配置 `*sql.db` 的连接池参数，导致连接泄漏或堆积。
该错误 并非 数据库连接“永久占用直到服务重启”，而是 PostgreSQL 达到了 max_connections（默认通常为 100，而非你查询到的理论上限 8388607）的硬限制，新连接请求被直接拒绝。你执行 SELECT ... WHERE name='max_connections' 返回的是编译时支持的最大值，实际生效值需查运行时配置：
SHOW max_connections; -- 查看当前生效值（通常是 100）
你的 Go 代码中存在两个关键隐患：
defer gest.Db.Close() 位置错误：它被写在 main() 函数末尾，但 main() 仅在程序退出时才执行 defer —— 这意味着数据库连接池永远不会被主动关闭，且更重要的是，它完全未生效于 HTTP 请求生命周期中。defer 在此处无实际作用，反而掩盖了连接池管理逻辑缺失的问题。
未配置连接池参数：sql.DB 是一个连接池抽象，默认 MaxOpenConns=0（无限制）、MaxIdleConns=2、ConnMaxLifetime=0（永不过期）。若并发请求激增，MaxOpenConns=0 会导致无限创建新连接直至打满 PostgreSQL 的 max_connections，从而触发报错。
✅ 正确做法是显式调优连接池，并确保初始化一次、全局复用（而非每次请求新建/关闭 DB）：
func InitDbUser() *sql.DB {
dbinfo := fmt.Sprintf("user=%s password=%s dbname=%s sslmode=disable", DB_USER, DB_PASSWORD, DB_NAME)
db, err := sql.Open("postgres", dbinfo)
if err != nil {
log.Fatal("Failed to open DB:", err)
}
// 关键：设置连接池参数（建议根据 PG max_connections 和服务负载调整）
db.SetMaxOpenConns(50) // 最大打开连接数（≤ PG max_connections，留余量给其他工具）
db.SetMaxIdleConns(20) // 最大空闲连接数
db.SetConnMaxLifetime(30 * time.Minute) // 连接最大存活时间，避免长连接僵死
db.SetConnMaxIdleTime(10 * time.Minute) // 空闲连接最大存活时间
// Ping 验证连通性
if err = db.Ping(); err != nil {
log.Fatal("Failed to ping DB:", err)
}
return db
}
func main() {
gest.Db = InitDbUser()
// ✅ 正确：DB 实例全局复用，不 defer Close；程序退出时再关闭（可选）
defer func() { _ = gest.Db.Close() }() // 放在 main 开头或确保只调用一次
// 启动 HTTP 服务...
http.ListenAndServe(":8080", nil)
}⚠️ 注意事项：
- 永远不要在每个 HTTP handler 中调用 sql.Open 或 db.Close()：这会摧毁连接复用，引发性能灾难和连接风暴；
- rows.Close() 仍需保留（尤其在 for rows.Next() 后），但它只释放单次查询的游标资源，不归还底层连接到池中；连接归还是由 database/sql 自动完成（当 rows 被 GC 或显式 Close 后，连接返回空闲池）；
- 若必须提高 PostgreSQL 的 max_connections，需同步增加内存（每个连接约占用数 MB 共享内存），并可能影响 WAL、锁管理和整体稳定性，优先优化应用层连接池而非盲目调高数据库上限；
- 推荐使用 pgx（原生 PostgreSQL 驱动）替代 lib/pq（已归档），它提供更精细的连接池控制和更好性能。
总结：错误根源是连接池失控，而非连接“永不释放”。通过合理设置 SetMaxOpenConns 等参数，配合正确复用 *sql.DB 实例，即可稳定支撑高并发场景。
