Golang客户端连接Postgres遇连接重置的问题排查与解决问询

一、首次请求失败、第二次有时成功的原因 #

• Postgres重启后，原有连接池内的TCP连接已被断开，但Go标准库database/sql（sqlx基于它实现）的连接池无法实时感知连接状态，仍会认为这些连接可用。首次请求时取出失效连接，执行数据库操作就会抛出driver: bad connection错误。
• 报错后，连接池会自动将这个失效连接从池中移除。第二次请求时，连接池会创建新的有效连接，因此能正常执行；但如果池内还有其他未被清理的失效连接，第二次请求可能再次取到坏连接，导致失败，直到所有失效连接都被清理完毕。

二、无需每次检查连接状态的规避方案 #

1. 针对连接失效错误增加自动重试 #

在业务代码中对driver: bad connection这类特定错误进行重试，不需要手动检查连接状态。示例代码：

import (
    "strings"
    "fmt"
    "github.com/jmoiron/sqlx"
)

func executeWithRetry(db *sqlx.DB, query string, args ...interface{}) error {
    const retryTimes = 2
    var err error
    for i := 0; i < retryTimes; i++ {
        _, err = db.Exec(query, args...)
        if err == nil {
            return nil
        }
        // 匹配连接失效错误，进行重试
        if strings.Contains(err.Error(), "driver: bad connection") {
            continue
        }
        return err
    }
    return fmt.Errorf("重试%d次后仍失败: %w", retryTimes, err)
}

2. 依赖连接池的自动清理机制 #

通过配置连接池参数，让它主动淘汰过期或闲置过久的连接，从根源上减少取出失效连接的概率，无需手动检查。

三、调整连接池参数解决问题 #

配置以下关键参数，优化连接池的连接管理：

• ConnMaxLifetime：设置连接的最大存活时长，比如1*time.Hour。超过该时长的连接会被连接池主动关闭，避免持有Postgres重启后的失效连接。
• ConnMaxIdleTime：设置连接的最大闲置时长，比如15*time.Minute。闲置过久的连接会被自动清理，减少失效连接堆积。
• MaxOpenConns：设置连接池允许的最大打开连接数，需匹配Postgres的max_connections配置，避免连接数超限。
• MaxIdleConns：设置连接池保留的最大闲置连接数，保持适量闲置连接提升性能，同时避免过多无效连接占用资源。

示例配置代码：

connPool, err := sqlx.Open("postgres", psqlInfo)
if err != nil {
    return nil, err
}

// 配置连接池参数
connPool.SetMaxOpenConns(20)
connPool.SetMaxIdleConns(10)
connPool.SetConnMaxLifetime(1 * time.Hour)
connPool.SetConnMaxIdleTime(15 * time.Minute)

if err := connPool.Ping(); err != nil {
    return nil, err
}

额外注意事项 #

避免手动调用connPool.DB.Connx()获取专用长连接，这类连接脱离连接池的自动管理，Postgres重启后会永久失效，无法自动恢复。应直接使用connPool.Queryx()、connPool.Exec()等方法，让连接池负责连接的分配、回收和健康管理。

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