PostgreSQL 53400 오류 원인과 해결 방법 완벽 가이드

53400
2026년 07월 16일 | DBMS Error 가이드

이 글에서 다루는 내용

53400 에러의 원인 분석, 해결 SQL, 예방 방법을 실무 관점에서 정리합니다.

53400 configuration limit exceeded 는?

PostgreSQL 에러 코드 53400 configuration limit exceeded는 데이터베이스 서버가 미리 설정된 구성(configuration) 한계치를 초과했을 때 발생하는 에러입니다. 주로 동시 접속자 수, 잠금(lock) 수, 또는 기타 시스템 자원 관련 설정 값이 한계에 도달했을 때 트리거됩니다. 이 에러는 단순한 쿼리 오류가 아니라 서버 레벨의 자원 고갈 문제이기 때문에, 즉각적인 조치를 취하지 않으면 서비스 전체에 영향을 줄 수 있습니다.

주요 발생 원인

1. 최대 연결 수(max_connections) 초과

max_connections는 PostgreSQL 서버가 허용하는 최대 동시 클라이언트 연결 수를 정의하는 핵심 파라미터입니다. 애플리케이션 서버가 커넥션 풀 관리를 제대로 하지 않거나, 갑작스러운 트래픽 급증으로 인해 연결이 쌓이게 되면 이 한계를 초과하게 됩니다. 특히 커넥션이 종료되지 않고 idle 상태로 오래 유지될 경우 실제 처리 가능한 연결 슬롯이 고갈될 수 있습니다.

2. 최대 잠금 수(max_locks_per_transaction) 초과

PostgreSQL은 트랜잭션당 획득할 수 있는 잠금(lock)의 수를 max_locks_per_transaction 파라미터로 제한합니다. 대규모 배치 작업, 수천 개의 파티션 테이블에 대한 동시 접근, 또는 복잡한 DDL 작업이 실행될 때 이 한계를 초과하는 경우가 많습니다. 잠금 테이블의 공유 메모리가 부족해지면 서버 전체에 영향을 미치는 심각한 오류로 이어질 수 있습니다.

3. 준비된 트랜잭션 수(max_prepared_transactions) 초과

max_prepared_transactions는 동시에 준비(prepared) 상태로 존재할 수 있는 트랜잭션의 최대 수를 설정합니다. 분산 데이터베이스 환경이나 2PC(Two-Phase Commit) 프로토콜을 사용하는 애플리케이션에서 준비된 트랜잭션이 정리되지 않고 누적되면 이 한계에 도달합니다. 기본값이 0으로 설정된 경우 2PC를 사용하는 애플리케이션에서 즉시 에러가 발생합니다.

해결 방법

1. 최대 연결 수 문제 해결

현재 연결 상태를 확인하고, 불필요한 연결을 정리합니다.

-- 현재 연결 현황 확인
SELECT 
    datname AS database,
    usename AS username,
    state,
    count(*) AS connection_count,
    max(now() - state_change) AS max_idle_time
FROM pg_stat_activity
GROUP BY datname, usename, state
ORDER BY connection_count DESC;

-- 유휴 상태(idle)인 연결 강제 종료 (주의: 실무 적용 전 반드시 검토)
SELECT pg_terminate_backend(pid)
FROM pg_stat_activity
WHERE state = 'idle'
  AND state_change < now() - interval '10 minutes'
  AND pid <> pg_backend_pid();

-- max_connections 현재 설정값 확인
SHOW max_connections;

-- 설정값 변경 (postgresql.conf 수정 후 재시작 필요)
-- ALTER SYSTEM SET max_connections = 500;
-- 변경 후 pg_ctl restart 또는 서비스 재시작 필요

커넥션 풀링 솔루션(PgBouncer, Pgpool-II)을 도입하는 것이 근본적인 해결책입니다.

-- PgBouncer 도입 전, 현재 연결 사용률 모니터링 쿼리
SELECT 
    count(*) AS total_connections,
    (SELECT setting::int FROM pg_settings WHERE name = 'max_connections') AS max_connections,
    round(count(*) * 100.0 / 
        (SELECT setting::int FROM pg_settings WHERE name = 'max_connections'), 2) AS usage_percent
FROM pg_stat_activity;

2. 최대 잠금 수 문제 해결

-- 현재 잠금 현황 확인
SELECT 
    locktype,
    relation::regclass AS table_name,
    mode,
    granted,
    pid,
    pg_blocking_pids(pid) AS blocked_by
FROM pg_locks
WHERE relation IS NOT NULL
ORDER BY granted, locktype;

-- max_locks_per_transaction 현재 설정 확인
SHOW max_locks_per_transaction;

-- 파티션 테이블이 많은 경우 잠금 사용량 추정
-- (파티션 수 * 동시 트랜잭션 수) 고려하여 설정
-- ALTER SYSTEM SET max_locks_per_transaction = 256;

-- 잠금을 오래 보유 중인 쿼리 확인 및 강제 종료
SELECT pid, now() - pg_stat_activity.query_start AS duration, query, state
FROM pg_stat_activity
WHERE (now() - pg_stat_activity.query_start) > interval '5 minutes'
  AND state != 'idle';

-- 특정 프로세스 강제 종료
SELECT pg_terminate_backend(pid)
FROM pg_stat_activity
WHERE pid = <문제가 되는 PID>;

3. 준비된 트랜잭션 문제 해결

-- 현재 준비된 트랜잭션 목록 확인
SELECT 
    gid AS transaction_id,
    prepared AS prepared_time,
    owner,
    database,
    now() - prepared AS age
FROM pg_prepared_xacts
ORDER BY prepared;

-- 오래된 준비된 트랜잭션 롤백 (정리)
ROLLBACK PREPARED 'transaction_id_여기에_입력';

-- 또는 커밋으로 정리
COMMIT PREPARED 'transaction_id_여기에_입력';

-- max_prepared_transactions 설정 확인 및 변경
SHOW max_prepared_transactions;
-- ALTER SYSTEM SET max_prepared_transactions = 100;
-- SELECT pg_reload_conf(); -- 일부 설정은 재로드로 적용 가능

예방 방법

1. 정기적인 모니터링 및 알림 설정

실무에서는 연결 수, 잠금 수, 준비된 트랜잭션 등 주요 지표를 Prometheus + Grafana 또는 pgBadger 등의 도구로 지속적으로 모니터링해야 합니다. 아래 쿼리를 cron 또는 모니터링 에이전트에 등록하여 임계치(예: max_connections의 80%) 초과 시 즉시 알림을 받도록 설정하는 것이 Best Practice입니다.

-- 모니터링용 연결 수 임계치 체크 쿼리
SELECT 
    CASE 
        WHEN (count(*) * 100.0 / 
              (SELECT setting::int FROM pg_settings WHERE name = 'max_connections')) > 80 
        THEN 'WARNING: Connection usage exceeds 80%!'
        ELSE 'OK'
    END AS status,
    count(*) AS current_connections,
    (SELECT setting::int FROM pg_settings WHERE name = 'max_connections') AS max_connections
FROM pg_stat_activity;

2. 커넥션 풀링 및 애플리케이션 레벨 자원 관리 강화

PgBouncer를 도입하여 애플리케이션과 PostgreSQL 사이에서 연결을 효율적으로 관리하고, 애플리케이션 코드에서는 반드시 try-finally 또는 with 구문을 사용하여 DB 연결이 항상 명시적으로 종료되도록 보장해야 합니다. 또한 idle_in_transaction_session_timeout과 statement_timeout을 적절히 설정하여 장기 유휴 세션과 장시간 실행 쿼리가 자동으로 종료되도록 구성하는 것이 재발 방지에 효과적입니다.

-- 유휴 트랜잭션 세션 자동 종료 설정 (10분)
ALTER SYSTEM SET idle_in_transaction_session_timeout = '10min';

-- 장기 실행 쿼리 자동 종료 설정 (30분)
ALTER SYSTEM SET statement_timeout = '30min';

SELECT pg_reload_conf();