// справочник ошибок PostgreSQL

PostgreSQL 53300: слишком много соединений

Сервер достиг максимального числа соединений (max_connections) и отказывает в новых сессиях. Обычно это связано с утечкой соединений или пулами, которые вместе открывают больше соединений, чем разрешено.

SQLSTATE
53300
Имя
too_many_connections
Категория
Недостаточно ресурсов
Сообщение об ошибке
sorry, too many clients already

Что это значит

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, занимая слоты и блокировки.
  • Резкий рост трафика или задача, которая открывает одно соединение на задачу.

Как исправить

  1. Смотрите, кто подключён и что делает (подключайтесь под суперпользователем — он ещё может войти).

    SELECT usename, application_name, client_addr, state, count(*)
    FROM pg_stat_activity
    GROUP BY 1, 2, 3, 4
    ORDER BY count(*) DESC;
  2. Завершайте сессии, зависшие в транзакции в простое, или принадлежащие вышедшему из-под контроля клиенту.

    SELECT pg_terminate_backend(pid)
    FROM pg_stat_activity
    WHERE state = 'idle in transaction'
      AND state_change < now() - interval '10 minutes';
  3. Исправьте утечку или уменьшите пулы, чтобы их суммарный объём оставался в пределах лимита, и поставьте перед множеством мелких клиентов пулер вроде PgBouncer.

  4. Настройте сервер на автоматическое завершение заброшенных сессий.

    ALTER SYSTEM SET idle_in_transaction_session_timeout = '5min';
    SELECT pg_reload_conf();
  5. Повышайте max_connections только если у сервера есть для этого память; требуется перезапуск.

    ALTER SYSTEM SET max_connections = 200;  -- takes effect after restart

Вопросы

Сколько подключений выдерживает PostgreSQL?

Максимальное количество соединений по умолчанию — 100. Каждое соединение — это отдельный процесс с собственной памятью, поэтому сотни в основном простаивающих соединений лучше обслуживаются пулером соединений, чем очень высоким max_connections.

Связанные ошибки

Больше ошибок нехватки ресурсов

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.