PostgreSQL连接池的配置是数据库性能优化的重要环节，合理的连接池设置既能减少连接创建销毁的开销，也能避免过多连接拖垮数据库。下面将从不同层面介绍具体的配置方法。
连接池的核心作用
PostgreSQL默认的最大连接数通常设置为100，如果应用直接频繁创建短连接，很容易达到连接上限，导致新的请求失败。连接池会预先创建一定数量的数据库连接，应用需要访问数据库时直接从池中获取可用连接，使用完毕后归还而不是关闭，大幅降低连接管理的成本。
应用层连接池配置（以Java HikariCP为例）
在Java应用中，通常会使用HikariCP作为PostgreSQL的数据源连接池，核心配置参数如下：
| 参数名 | 作用 | 建议值 |
|---|---|---|
| maximumPoolSize | 连接池最大连接数 | 建议为数据库最大连接数的1/4到1/3，避免占满数据库资源 |
| minimumIdle | 最小空闲连接数 | 根据业务并发量设置，低并发场景可设为5-10 |
| connectionTimeout | 获取连接的超时时间 | 30000毫秒（30秒） |
| idleTimeout | 空闲连接的最大存活时间 | 600000毫秒（10分钟） |
对应的配置代码示例：
import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
import javax.sql.DataSource;
public class PostgresPoolConfig {
public static DataSource createDataSource() {
HikariConfig config = new HikariConfig();
// PostgreSQL连接地址，示例替换为实际地址
config.setJdbcUrl("jdbc:postgresql://127.0.0.1:5432/test_db");
config.setUsername("postgres");
config.setPassword("your_password");
// 最大连接数
config.setMaximumPoolSize(20);
// 最小空闲连接数
config.setMinimumIdle(5);
// 连接超时时间，单位毫秒
config.setConnectionTimeout(30000);
// 空闲连接超时时间，单位毫秒
config.setIdleTimeout(600000);
// 连接最大存活时间，单位毫秒
config.setMaxLifetime(1800000);
return new HikariDataSource(config);
}
}中间件层连接池配置（以pgbouncer为例）
如果多个应用需要访问同一个PostgreSQL实例，使用pgbouncer作为中间件连接池可以统一管理连接，减少数据库侧的连接压力。pgbouncer的核心配置文件是pgbouncer.ini，关键配置如下：
[databases] # 配置数据库映射，test_db是池内标识，后面的连接串指向实际PostgreSQL实例 test_db = host=127.0.0.1 port=5432 dbname=test_db user=postgres password=your_password [pgbouncer] # 监听地址和端口 listen_addr = 0.0.0.0 listen_port = 6432 # 连接池模式，session表示会话级池化，statement表示语句级池化，transaction表示事务级池化 pool_mode = transaction # 每个数据库的最大连接数 default_pool_size = 20 # 最大客户端连接数 max_client_conn = 100 # 连接空闲超时时间，单位秒 server_idle_timeout = 600 # 日志文件路径 logfile = /var/log/pgbouncer/pgbouncer.log # pid文件路径 pidfile = /var/run/pgbouncer/pgbouncer.pid
配置完成后启动pgbouncer，应用只需要连接pgbouncer的6432端口，就可以间接访问PostgreSQL数据库，连接管理由pgbouncer统一处理。
配置注意事项
- 连接池的最大连接数不要设置过高，需要结合PostgreSQL的
max_connections参数调整，避免数据库侧连接耗尽 - 连接超时时间需要根据业务实际响应时间设置，过短会导致正常请求获取不到连接，过长会导致请求堆积
- 如果应用有突发流量，可以适当调大最小空闲连接数，避免突发请求时频繁创建连接
- 定期检查连接池的使用情况，通过连接池提供的监控接口查看活跃连接数、等待连接数等指标，动态调整参数
验证配置是否生效
可以通过PostgreSQL的系统视图查看当前连接情况，判断连接池是否正常工作：
-- 查看当前所有连接的来源和状态 SELECT pid, usename, application_name, client_addr, state FROM pg_stat_activity; -- 统计当前连接数 SELECT count(*) FROM pg_stat_activity;
如果应用端配置了连接池，正常情况下会看到固定数量的来自连接池所在地址的连接，而不是频繁变化的大量短连接，说明连接池已经生效。
PostgreSQL连接池数据源配置pgbouncer最大连接数修改时间：2026-05-30 21:42:03