Go语言database/sql MySQL连接池连接未按预期保留问题问询

核心原因：连接池被提前关闭 #

你的代码中存在致命问题：defer pool.Close()被放在了连接池初始化的局部函数中。当该初始化函数执行完毕时，defer语句会触发pool.Close()直接关闭整个连接池。

此时连接池不再持有任何空闲连接，后续每次调用pool.Conn(ctx)都会新建连接；用完调用conn.Close()归还时，因为连接池已关闭，这些连接会被直接销毁，最终导致空闲连接快速归零，形成你看到的锯齿状波动。

解决办法 #

移除初始化函数中的defer pool.Close()，将连接池的关闭逻辑移到应用退出阶段执行，比如通过信号监听实现优雅关闭：

func main() {
    var err error
    pool, err = sql.Open("driver-name", *dsn)
    if err != nil {
        log.Fatal(err)
    }

    // 配置连接池参数
    pool.SetMaxOpenConns(256)
    pool.SetMaxIdleConns(256)
    pool.SetConnMaxLifetime(3*time.Hour)
    pool.SetConnMaxIdleTime(3*time.Hour)

    // 监听退出信号，优雅关闭连接池
    sigChan := make(chan os.Signal, 1)
    signal.Notify(sigChan, syscall.SIGINT, syscall.SIGTERM)
    go func() {
        <-sigChan
        log.Println("正在关闭连接池...")
        if err := pool.Close(); err != nil {
            log.Printf("关闭连接池失败: %v", err)
        }
        os.Exit(0)
    }()

    // 启动应用服务逻辑
    // ...
}

其他排查方向 #

如果调整后问题仍存在，可检查以下内容：

• MySQL服务器端超时配置：查看MySQL的wait_timeout和interactive_timeout值，若这两个值小于你设置的ConnMaxIdleTime（3小时），MySQL会主动断开空闲连接，客户端连接池检测到后会回收这些连接。可通过SHOW VARIABLES LIKE 'wait_timeout';查看，必要时修改MySQL配置文件调整。
• 代码逻辑错误：确认是否有其他代码错误调用了pool.Close()，或者对pool变量进行了重新赋值，导致连接池实例被替换或意外关闭。

内容的提问来源于stack exchange，提问作者pnndesh