Rails侧解决PgBouncer client_idle_timeout连接断开问题咨询

针对你的Ruby 2.0.0 + Rails 4.2.3 + pg 0.17.1环境，遇到PgBouncer因client_idle_timeout=60秒断开闲置连接后，Rails查询报错的问题，这里有几个靠谱的Rails侧解决方案：

方案1：调整ActiveRecord连接池配置（无需额外gem） #

直接修改config/database.yml，添加以下配置项，让Rails主动管理连接生命周期，避免使用失效连接：

# 以production环境为例，其他环境同理
production:
  adapter: postgresql
  database: your_db_name
  username: your_username
  password: your_password
  host: your_pgbouncer_host
  port: 6432 # PgBouncer默认端口
  # 核心配置
  reaping_frequency: 30 # 每30秒检查并回收闲置连接，比60秒超时短
  checkout_timeout: 10 # 获取连接的超时时间，避免等待无效连接
  connect_timeout: 5 # 建立新连接的超时时间

配置说明： #

• reaping_frequency：Rails会定期（这里是30秒）扫描连接池里的闲置连接，把超时的连接断开并移除，这样池子里不会留着被PgBouncer干掉的无效连接。
• checkout_timeout：如果连接池里暂时没有可用连接，等待10秒后就放弃，避免无限等待失效连接。

方案2：添加连接验证钩子（确保取出的连接是活的） #

如果上面的配置还偶尔出现问题，可以加一个初始化钩子，每次从连接池取连接时先验证是否活跃，失效就重连：
创建config/initializers/active_record_connection_check.rb，写入以下代码：

ActiveRecord::Base.connection_pool.prepend(Module.new do
  def checkout
    connection = super
    # 检查连接是否活跃，pg gem的active?方法会发送简单查询验证
    unless connection.active?
      # 断开失效连接
      disconnect!
      # 重新获取一个新连接
      connection = super
    end
    connection
  end
end)

这个代码会在每次取出连接时做健康检查，一旦发现连接已经被PgBouncer断开，就主动销毁它并重新建立新连接，从根源上避免使用失效连接。

方案3：调整连接池大小（辅助优化） #

如果你的应用并发不高，可以适当调小连接池的pool值，比如：

production:
  # 其他配置...
  pool: 5

更小的连接池意味着闲置连接更少，被PgBouncer触发超时断开的概率也会降低，同时也能减轻PgBouncer和PostgreSQL的压力。

为什么会出现这个错误？ #

PgBouncer的client_idle_timeout会自动断开超过60秒没有活动的客户端连接，但Rails的连接池还会把这个已经失效的连接保留在池子里。当你后续执行查询时，Rails会取出这个失效连接，就会抛出PG::ConnectionBad: PQconsumeInput() SSL connection has been closed unexpectedly的错误。

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