PostgreSQL 53300: слишком много соединений
Сервер достиг максимального числа соединений (max_connections) и отказывает в новых сессиях. Обычно это связано с утечкой соединений или пулами, которые вместе открывают больше соединений, чем разрешено.
- SQLSTATE
53300- Имя
too_many_connections- Категория
- Недостаточно ресурсов
Что это значит
PostgreSQL запускает один серверный процесс на каждое соединение и ограничивает общее количество с помощью max_connections (по умолчанию 100). Когда все слоты заняты, новое соединение завершится с ошибкой 53300 до того, как удастся войти.
Некоторые слоты резервируются для суперпользователей (superuser_reserved_connections, по умолчанию 3) и, начиная с PostgreSQL 16, для ролей в pg_use_reserved_connections. Обычные роли затем видят remaining connection slots are reserved for roles with the SUPERUSER attribute (формулировка зависит от версии) с тем же кодом. Роль или база данных также могут иметь свой собственный CONNECTION LIMIT, что приводит к сбою с too many connections for role "app".
Распространённые причины
- Приложение теряет соединения (утечка): оно открывает их и никогда не закрывает и не возвращает в пул.
- Несколько экземпляров приложения, каждый со своим пулом, в сумме превышают
max_connections. - Много сессий стоят
idle in transaction, занимая слоты и блокировки. - Резкий рост трафика или задача, которая открывает одно соединение на задачу.
Как исправить
-
Смотрите, кто подключён и что делает (подключайтесь под суперпользователем — он ещё может войти).
SELECT usename, application_name, client_addr, state, count(*) FROM pg_stat_activity GROUP BY 1, 2, 3, 4 ORDER BY count(*) DESC;
-
Завершайте сессии, зависшие в транзакции в простое, или принадлежащие вышедшему из-под контроля клиенту.
SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE state = 'idle in transaction' AND state_change < now() - interval '10 minutes';
-
Исправьте утечку или уменьшите пулы, чтобы их суммарный объём оставался в пределах лимита, и поставьте перед множеством мелких клиентов пулер вроде PgBouncer.
-
Настройте сервер на автоматическое завершение заброшенных сессий.
ALTER SYSTEM SET idle_in_transaction_session_timeout = '5min'; SELECT pg_reload_conf();
-
Повышайте
max_connectionsтолько если у сервера есть для этого память; требуется перезапуск.ALTER SYSTEM SET max_connections = 200; -- takes effect after restart
Вопросы
Сколько подключений выдерживает PostgreSQL?
Максимальное количество соединений по умолчанию — 100. Каждое соединение — это отдельный процесс с собственной памятью, поэтому сотни в основном простаивающих соединений лучше обслуживаются пулером соединений, чем очень высоким max_connections.
Связанные ошибки
57P03не удается подключиться сейчас25P03тайм-аут простоя в транзакции28000недопустимая спецификация авторизации1040MySQL: Слишком много соединенийORA-00018Oracle: превышено максимальное количество сессийORA-00020Oracle: превышено максимальное количество процессов
Больше ошибок нехватки ресурсов
Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.
Работа с PostgreSQL в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.