Go PostgreSQL连接池无法收缩问题咨询：如何降低池大小并关闭空闲连接

核心问题分析 #

从你的统计数据来看：

• 初始状态下连接池被完全占满（InUse:250），还存在连接等待队列，说明原池大小不足以支撑业务请求；
• 调整到2000后MaxIdleClosed:0，证明空闲连接没有被主动回收，这是因为你的连接池缺少空闲连接超时回收的配置，同时可能存在连接泄漏的情况。

具体解决方案 #

1. 添加空闲连接超时配置

当前代码仅设置了ConnMaxLifetime（连接最大存活时间），但没有设置ConnMaxIdleTime（连接最大空闲时间）。这个参数控制空闲连接在池中的存活时长，超过时间的连接会被自动关闭。在连接池初始化代码中添加：

// 设置连接最大空闲时间，比如5分钟，空闲超过此时长的连接会被回收
dbConn.SetConnMaxIdleTime(time.Duration(viper.GetInt("DB_CONN_IDLE_TIME")) * time.Minute)

建议将DB_CONN_IDLE_TIME配置为5-10分钟，既避免频繁创建连接，又能及时回收闲置资源。

2. 修正MaxIdleConns配置并合理设置阈值

确保MaxIdleConns的值不超过MaxOpenConns。如果需要快速回收所有空闲连接，可以临时将MaxIdleConns设为0（此时空闲连接会被立即关闭），之后再调回合理值（比如业务峰值的10%-20%）：

// 临时关闭所有空闲连接
dbConn.SetMaxIdleConns(0)
// 业务低峰期再调回合理值，比如20
// dbConn.SetMaxIdleConns(20)

3. 排查并修复连接泄漏

初始状态下所有连接都处于InUse状态，大概率是代码中存在连接未正确释放的情况：

• 查询结果未关闭：使用Query获取rows后，必须调用rows.Close()，建议用defer确保执行：

  rows, err := dbConn.Query("SELECT id FROM users")
  if err != nil {
      // 错误处理
      return
  }
  defer rows.Close() // 必须添加，否则连接不会归还到池
  

• 事务未提交/回滚：开启事务后，无论操作成功失败，都要执行Commit或Rollback，否则连接会一直被占用：

  tx, err := dbConn.Begin()
  if err != nil {
      // 错误处理
      return
  }
  defer func() {
      if r := recover(); r != nil {
          _ = tx.Rollback()
      }
  }()
  // 执行事务操作
  if err := tx.Exec("INSERT INTO ...").Err(); err != nil {
      _ = tx.Rollback()
      // 错误处理
      return
  }
  if err := tx.Commit(); err != nil {
      // 错误处理
      return
  }
  

4. 合理调整MaxOpenConns到实际需求值

从调整后的统计看，业务实际使用的连接数峰值在151左右，建议将MaxOpenConns设为200（比峰值高20%左右），避免池过大浪费数据库资源，同时能应对突发流量。

5. 监控连接池状态

定期打印或上报dbConn.Stats()数据，重点关注：

• MaxIdleClosed：被空闲超时回收的连接数，确认配置生效；
• InUse：实时使用的连接数，判断是否还有连接泄漏；
• WaitCount：连接等待次数，判断池大小是否足够。

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