// 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은 몇 개의 연결을 처리할 수 있나요?

기본 max_connections는 100입니다. 각 연결은 고유한 메모리를 가진 별도의 프로세스이므로, 주로 유휴인 수백 개의 연결은 매우 높은 max_connections보다는 연결 풀러가 더 적합합니다.

관련 오류

그 밖의 리소스 부족 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 PostgreSQL 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.