PostgreSQL连接数过多怎么调？

当PostgreSQL报出“FATAL: too many connections”错误时，意味着数据库连接数已触及上限，服务可能瞬间不可用；本文手把手教你三步破局：先精准诊断当前连接负载与配置瓶颈，再用`pg_terminate_backend`秒级清理闲置连接应急恢复，最后通过安全调优`max_connections`并同步优化应用层连接池（如HikariCP），从系统配置到代码实践双管齐下，彻底告别连接耗尽危机——不仅解决眼前故障，更构建高并发下的长效稳定连接管理机制。

如果您尝试连接PostgreSQL数据库时收到“FATAL: too many connections”错误提示，这表明当前客户端连接数已达到数据库配置的最大限制。以下是解决此问题的步骤：

一、查看当前最大连接数与实际使用情况

该方法用于确认数据库当前的连接上限及实时占用量，避免盲目调高参数。需通过psql或其他具备超级用户权限的客户端执行查询。

1、以postgres用户身份登录数据库：sudo -u postgres psql -d postgres

2、查询当前最大连接数配置：SHOW max_connections;

3、查询当前活跃连接总数：SELECT COUNT(*) FROM pg_stat_activity;

4、查看为超级用户预留的连接数：SHOW superuser_reserved_connections;

二、临时释放空闲连接（无需重启）

该方法可立即释放处于idle状态的连接，快速恢复服务可用性，适用于紧急故障响应场景。

1、列出所有空闲连接及其进程ID：SELECT pid, usename, datname, state, backend_start FROM pg_stat_activity WHERE state = 'idle';

2、强制终止全部空闲连接：SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE state = 'idle';

3、如需仅终止指定用户或数据库的空闲连接，可添加WHERE条件，例如：WHERE usename = 'app_user' AND datname = 'mydb'

三、修改postgresql.conf永久提升max_connections

该方法通过调整核心配置参数扩大连接容量，但需注意内存开销与操作系统级资源限制。

1、定位配置文件路径：SHOW config_file;

2、编辑postgresql.conf文件，找到并修改以下行：max_connections = 200（建议根据服务器内存合理设定，每连接约消耗4–10MB内存）

3、检查操作系统文件描述符限制是否足够：ulimit -n，若低于新设max_connections值，需同步调整系统ulimit

4、保存文件后重启PostgreSQL服务：sudo systemctl restart postgresql（或对应平台命令）

四、使用ALTER SYSTEM动态设置（PostgreSQL 9.4+）

该方法避免直接编辑配置文件，由数据库自身管理配置变更，降低人为误操作风险。

1、在psql中执行动态修改命令：ALTER SYSTEM SET max_connections = 300;

2、重载配置使部分参数生效（但max_connections仍需重启）：SELECT pg_reload_conf();

3、执行重启操作：sudo systemctl restart postgresql

五、检查并优化应用层连接池配置

该方法从源头减少无效连接堆积，防止连接数被多个服务实例重复耗尽，是长期稳定运行的关键措施。

1、确认各微服务或应用模块的连接池最大连接数总和未超过数据库max_connections值

2、对于HikariCP，检查配置项：maximumPoolSize是否设置过高（例如每个服务设100，5个服务即达500）

3、启用连接泄漏检测：leakDetectionThreshold=60000（单位毫秒）

4、设置合理的空闲连接存活时间：idleTimeout=600000（10分钟）

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PostgreSQL连接数过多怎么调？》文章吧，也可关注golang学习网公众号了解相关技术文章。