“fatal: too many connections”错误表明postgresql连接数已达max_connections上限。需先查show max_connections和select count(*) from pg_stat_activity确认现状；再用pg_terminate_backend释放idle连接应急；最后通过修改postgresql.conf中max_connections并重启服务，同时优化应用连接池配置防复发。

如果您尝试连接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分钟）