---

title: PgBouncer 连接池配置与模式选择

keywords:

• PgBouncer
• 连接池
• pool_mode
• transaction
• session

description: 配置 PgBouncer 连接池与选择合适的 pool_mode，提供 pgbouncer.ini 与用户认证文件示例。

tags:

• PgBouncer
• PostgreSQL
• pool_mode
• session
• transaction
• 数据库
• 运维
• 连接池

categories:

• 文章资讯
• 软件教程

---

PgBouncer 连接池配置与模式选择

pgbouncer.ini 示例

[databases]
app = host=127.0.0.1 port=5432 dbname=app

[pgbouncer]
listen_addr = 0.0.0.0
listen_port = 6432
auth_type = md5
auth_file = /etc/pgbouncer/userlist.txt
pool_mode = transaction
max_client_conn = 1000
default_pool_size = 50
server_reset_query = DISCARD ALL

用户文件

"app" "md5xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

模式选择

• session：连接贯穿会话，兼容性最好，池化效率最低
• transaction：事务级复用，推荐默认
• statement：语句级复用，需确保无会话状态依赖

验证

• 通过 SHOW POOLS; 观察池内连接与使用情况

总结

根据工作负载选择 pool_mode 并配置认证/池大小，可显著提升连接利用率与稳定性。