PgBouncer连接池与事务隔离实践

---

title: PgBouncer连接池与事务隔离实践

keywords:

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

description: 配置PgBouncer连接池并选择合适的pool_mode与事务隔离策略，提供可验证的INI与命令，提升并发与稳定性。

date: 2025-11-26

tags:

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

categories:

• 文章资讯
• 编程技术

---

概述

• 目标：通过PgBouncer复用数据库连接，降低连接创建开销，并选择transaction/session模式保证功能与性能平衡。
• 适用：高并发短事务场景、微服务与函数式查询负载。

核心与实战

• 配置示例（pgbouncer.ini）：

[databases]
app = host=db port=5432 dbname=app user=app_rw password=secret

[pgbouncer]
listen_port = 6432
listen_addr = 0.0.0.0
auth_type = md5
auth_file = /etc/pgbouncer/userlist.txt
pool_mode = transaction
max_client_conn = 2000
default_pool_size = 100
reserve_pool_size = 20
server_reset_query = DISCARD ALL
ignore_startup_parameters = extra_float_digits
server_tls_sslmode = disable

• 用户文件：

"app_rw" "md5xxxxxxxxxxxxxxxx"

• 启动与检查：

pgbouncer -d /etc/pgbouncer/pgbouncer.ini
psql 'host=127.0.0.1 port=6432 dbname=app user=app_rw password=secret' -c 'SHOW VERSION;'

示例

• 切换为session模式（需要会话级特性）：

pool_mode = session

• 观测池与等待：

psql -h 127.0.0.1 -p 6432 -U app_rw -d pgbouncer -c 'SHOW POOLS;'
psql -h 127.0.0.1 -p 6432 -U app_rw -d pgbouncer -c 'SHOW STATS;'

验证与监控

• 并发效果：
• 观察后端连接数是否被池化；客户端连接与等待比例。
• 事务隔离：
• transaction模式适合短事务；session模式保留会话特性（例如临时表）。
• 安全与重置：
• 使用server_reset_query=DISCARD ALL清理会话状态；避免状态泄露。

常见误区

• 使用transaction模式但依赖会话功能（临时表/SET变量）；需改为session或调整逻辑。
• 池大小过大导致后端连接饱和；需根据数据库资源设定。
• 未配置ignore_startup_parameters导致兼容性问题；需忽略不必要参数。

结语

• PgBouncer通过连接池化提升并发与稳定性；合理选择pool_mode与重置策略，可在生产中安全高效地服务多客户端。