☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
应启用pgbouncer连接池并配置transaction模式，同时调整postgresql的idle_in_transaction_session_timeout参数、sqlalchemy预检测、hikaricp空闲回收及tcp keepalive协同调优。
如果您尝试优化postgresql长连接导致的资源耗尽问题，但发现连接持续占用不释放，则很可能是由于缺少连接池层或连接池配置不当。以下是解决此问题的步骤：
一、启用PgBouncer连接池并配置transaction模式
PgBouncer是轻量级中间件连接池，以进程模型复用后端连接，避免每个客户端请求独占一个PostgreSQL后端进程。采用transaction模式可在事务结束后立即归还连接，显著降低后端连接数峰值。
1、下载并安装PgBouncer（以Debian/Ubuntu为例）：
sudo apt update && sudo apt install pgbouncer
2、编辑主配置文件 /etc/pgbouncer/pgbouncer.ini：
pool_mode = transaction
max_client_conn = 2000
default_pool_size = 50
min_pool_size = 5
reserve_pool_size = 10
3、在 [databases] 段落中添加目标数据库映射：
mydb = host=127.0.0.1 port=5432 dbname=mydb
4、配置用户列表文件 /etc/pgbouncer/userlist.txt，格式为："username" "md5..."（可使用pg_md5生成哈希）
5、重启服务：
sudo systemctl restart pgbouncer
二、调整PostgreSQL内置空闲事务超时参数
PostgreSQL自身提供机制终止长时间空闲的事务会话，防止连接被挂起却无实际操作，从而释放连接槽位。该方式无需引入新组件，适用于无法部署中间件的受限环境。
1、登录PostgreSQL（需超级用户权限）：
sudo -u postgres psql -d postgres
2、执行运行时参数修改（临时生效）：
SET idle_in_transaction_session_timeout = '30s';
3、若需永久生效，编辑 postgresql.conf：
idle_in_transaction_session_timeout = 30s
4、保存后重启数据库：
sudo systemctl restart postgresql
三、在应用层启用SQLAlchemy连接池预检测
当应用使用SQLAlchemy作为ORM时，连接可能因网络闪断或服务重启而失效，但连接池未感知，继续复用已断开连接，导致后续请求失败并堆积新连接。启用pre-ping机制可在每次取连接前执行SELECT 1探测，自动剔除无效连接。
1、在创建Engine时显式设置pool_pre_ping=True：
engine = create_engine(url, pool_pre_ping=True)
使用Perplexity API进行网络搜索的AI助手。当用户需要最新信息并附有来源引用、时事事实查询，或研究类答案时使用。当用户提及Perplexity或需要带有参考文献的最新信息时，默认使用此技能。
2、若使用环境变量驱动配置（如SpiffWorkflow），设置：
SPIFFWORKFLOW_BACKEND_SQLALCHEMY_POOL_PRE_PING=true
3、确认连接池最小空闲数与最大数匹配业务波峰，例如：
pool_size=20, max_overflow=30
四、配置HikariCP连接池主动回收空闲连接
HikariCP是Java生态高性能连接池，其空闲连接回收依赖于连接池自身定时扫描机制，而非等待数据库侧超时。合理配置可避免连接泄漏累积，尤其适合低频但长生命周期的应用场景。
1、设置连接最大存活时间（防老化）：
maxLifetime=1800000（30分钟）
2、启用空闲连接驱逐策略：
idleTimeout=600000（10分钟）
minimumIdle=5
3、强制校验连接有效性：
connectionTestQuery=SELECT 1
validationTimeout=3000
4、关键提示：
务必关闭autoCommit=false场景下的connection-timeout误配，否则空闲连接可能被过早标记为失效
五、操作系统级TCP Keepalive参数协同调优
当客户端异常退出（如kill -9）、网络中断或防火墙静默丢包时，PostgreSQL后端进程无法及时感知连接断开，形成“半开连接”，持续占用连接槽位。启用并调低TCP keepalive探测周期，可加速僵尸连接清理。
1、修改postgresql.conf：
tcp_keepalives_idle = 60
tcp_keepalives_interval = 10
tcp_keepalives_count = 5
2、同步调整系统级参数（Linux）：
echo 60 > /proc/sys/net/ipv4/tcp_keepalive_time
echo 10 > /proc/sys/net/ipv4/tcp_keepalive_intvl
echo 5 > /proc/sys/net/ipv4/tcp_keepalive_probes
3、使配置持久化（写入 /etc/sysctl.conf）：
net.ipv4.tcp_keepalive_time = 60
net.ipv4.tcp_keepalive_intvl = 10
net.ipv4.tcp_keepalive_probes = 5
