pgbouncer是postgresql的轻量级连接池中间件，通过在客户端和数据库间复用连接，降低高并发下的资源消耗。它支持会话、事务和语句级连接池模式，推荐生产环境使用事务级模式以平衡性能与兼容性。配置主要包括pgbouncer.ini设置监听地址、端口、认证方式及数据库映射，用户凭据存于userlist.txt并用pg_md5生成加密密码。安装可通过系统包管理器完成，启动后客户端需连接pgbouncer的6432端口而非直接访问数据库。内置管理接口支持通过psql连接pgbouncer数据库执行show clients、show servers、show pools、show stats等命令监控状态，reload可动态加载配置。合理部署pgbouncer能显著提升数据库稳定性和吞吐量，适用于web应用与微服务等高并发场景。
PostgreSQL 使用 PgBouncer 作为轻量级连接池，能有效减少数据库的连接开销，提升应用性能。尤其在高并发场景下，直接让大量客户端连接到数据库会造成资源耗尽，而 PgBouncer 作为中间层，管理连接的复用，减轻后端压力。
什么是 PgBouncer
PgBouncer 是一个轻量级的 PostgreSQL 连接池中间件，它位于客户端和 PostgreSQL 服务器之间，负责缓存和复用数据库连接。它不解析 SQL，只转发协议消息，因此资源消耗极低，适合大规模部署。
主要特性包括：
- 支持会话级、事务级和语句级连接池模式
- 内存占用小，运行稳定
- 可配置用户映射和认证方式
- 支持 TLS 加密连接
安装与基本配置
大多数 Linux 发行版可通过包管理器安装 PgBouncer：
Ubuntu/Debian:sudo apt install pgbouncer
CentOS/RHEL:sudo yum install pgbouncer 或使用 dnf
主要配置文件通常位于：
- pgbouncer.ini：主配置文件
- userlist.txt：用户认证信息
- database.ini 或内嵌在 pgbouncer.ini 中：数据库映射
示例 pgbouncer.ini 配置片段：
[pgbouncer] listen_addr = 0.0.0.0 listen_port = 6432 auth_type = md5 auth_file = /etc/pgbouncer/userlist.txt logfile = /var/log/postgresql/pgbouncer.log pidfile = /run/postgresql/pgbouncer.pid admin_users = admin_user [databases] myapp_db = host=127.0.0.1 port=5432 dbname=myapp
userlist.txt 内容格式（用户名和密码）：
"admin_user" "hashed_password"
密码可用 pg_md5 工具生成：pg_md5 mypassword
连接池模式说明
PgBouncer 支持三种连接池策略，根据业务需求选择：
- session：每个客户端连接对应一个服务器连接，直到会话断开。默认模式，兼容性最好
- transaction：客户端连接在事务开始时获取后端连接，事务结束即释放。适合短事务应用，节省连接数
- statement：每个 SQL 语句执行时分配连接，遇到多语句事务会自动升级为 transaction 模式。最节省连接，但不支持事务跨语句
推荐生产环境使用 transaction 模式，在性能和兼容性之间取得平衡。
启动与连接使用
配置完成后，启动服务：
sudo systemctl start pgbouncer
或直接运行：pgbouncer /etc/pgbouncer/pgbouncer.ini
客户端连接时，指向 PgBouncer 监听的地址和端口（如 6432），而不是直接连 PostgreSQL 的 5432 端口：
例如使用 psql：
psql -h localhost -p 6432 -U admin_user -d myapp_db
应用中的数据库连接字符串也需修改为 PgBouncer 的地址和端口。
监控与管理
PgBouncer 提供内置管理控制台，通过特殊数据库名 pgbouncer 登录即可查看状态：
psql -h localhost -p 6432 -U admin_user pgbouncer
常用管理命令：
- SHOW CLIENTS;：查看客户端连接
- SHOW SERVERS;：查看后端连接
- SHOW POOLS;：查看连接池状态
- SHOW STATS;：查看请求统计
- RELOAD;：重新加载配置
通过这些命令可以实时了解连接使用情况，排查瓶颈。
基本上就这些。合理配置 PgBouncer 能显著提升 PostgreSQL 应用的稳定性和吞吐能力，特别适合 Web 应用、微服务等高并发场景。不复杂但容易忽略细节，比如认证方式和连接模式的选择。
