Flask+SQLAlchemy配置pool_recycle未回收PostgreSQL pg_stat_activity中idle连接问题咨询

问题原因解析 #

1. 为什么pool_recycle没有回收超过10分钟的idle连接 #

SQLAlchemy的pool_recycle是被动触发机制，无后台线程主动扫描空闲连接：仅当应用尝试从连接池中取出连接执行新操作时，才会校验连接的存活时长，超过pool_recycle阈值的旧连接才会被销毁重建。
如果业务处于低峰期、长时间没有新的数据库操作请求，连接池中的空闲连接会一直保持idle状态被PostgreSQL统计到，属于正常机制，不是配置错误。

2. 多次调用db.session.commit是不是问题诱因 #

不是。每次db.session.commit执行完成后，当前会话绑定的数据库连接会被立即释放回连接池，不会被会话持续持有。你提到的flush加单次commit的写法只是减少了事务提交次数，和连接长期idle的问题没有关联。

实现10分钟自动关闭空闲连接的方案 #

方案1：应用侧优化连接池配置（适配低流量场景） #

调整你的引擎配置，限制连接池的最大常驻连接数，避免堆积不必要的空闲连接：

flask_app.config['SQLALCHEMY_ENGINE_OPTIONS'] = {
    "pool_pre_ping": True,
    "pool_recycle": 600,
    "pool_size": 5, # 根据实际并发调整，低流量场景5-10足够
    "max_overflow": 2 # 超过pool_size的临时连接用完即销毁，不进入常驻池
}

方案2：PostgreSQL侧配置主动超时（最稳妥的强制管控方案） #

直接在PostgreSQL配置文件postgresql.conf中添加超时规则，数据库会主动扫描关闭超时的空闲连接：

# 单位为毫秒，以下配置均为10分钟超时
# 关闭处于空闲状态的事务连接（PostgreSQL 9.6+支持）
idle_in_transaction_session_timeout = 600000
# 关闭完全空闲的普通连接（PostgreSQL 14+支持）
idle_session_timeout = 600000

配置修改后执行SELECT pg_reload_conf();生效即可，不需要重启数据库。

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