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

08006
2026년 08월 03일 | DBMS Error 가이드

이 글에서 다루는 내용

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

08006 connection failure 는?

PostgreSQL 에러 코드 08006 (connection_failure) 는 클라이언트가 PostgreSQL 서버와의 연결을 시도하거나 유지하는 도중 예기치 않게 연결이 끊어졌을 때 발생하는 에러입니다. 이 에러는 네트워크 장애, 서버 프로세스 종료, 방화벽 타임아웃 등 다양한 인프라 수준의 문제에서 기인하며, 애플리케이션 레이어에서 갑작스러운 쿼리 실패나 트랜잭션 롤백으로 이어질 수 있습니다. 특히 장시간 실행되는 트랜잭션이나 유휴 상태의 커넥션에서 자주 발생하므로, 운영 환경에서는 반드시 커넥션 상태 모니터링과 재연결 로직이 필요합니다.

주요 발생 원인

1. 네트워크 불안정 또는 방화벽/로드밸런서의 타임아웃

가장 흔한 원인으로, 클라이언트와 PostgreSQL 서버 사이에 위치한 방화벽이나 로드밸런서가 일정 시간 이상 유휴 상태인 커넥션을 강제로 종료하는 경우입니다. AWS RDS, Azure Database, GCP Cloud SQL과 같은 클라우드 환경에서는 기본적으로 수 분~수십 분 내에 유휴 커넥션을 끊는 정책이 적용되어 있어, 커넥션 풀을 사용하더라도 해당 에러가 빈번하게 발생할 수 있습니다. 이로 인해 애플리케이션이 이미 만료된 커넥션을 재사용하려 할 때 08006 에러가 트리거됩니다.

2. PostgreSQL 서버의 max_connections 초과 또는 서버 프로세스 비정상 종료

PostgreSQL은 max_connections 파라미터로 최대 동시 접속 수를 제한합니다. 접속 수가 한계에 도달하면 새로운 커넥션 요청이 거부되거나 기존 백엔드 프로세스가 OOM Killer 등에 의해 강제 종료될 수 있으며, 이 과정에서 클라이언트 측에는 08006 에러가 반환됩니다. 특히 커넥션 풀 없이 애플리케이션 서버를 스케일 아웃할 경우 이 문제가 급격히 악화됩니다.

3. keepalive 설정 미흡으로 인한 OS 레벨 커넥션 드롭

TCP 레벨에서 keepalive가 올바르게 설정되지 않으면, OS가 유휴 커넥션을 정리하거나 중간 네트워크 장비가 세션을 만료시켜도 PostgreSQL 서버와 클라이언트 양쪽 모두 연결이 살아있다고 착각하는 “좀비 커넥션” 현상이 발생합니다. 이후 해당 커넥션으로 실제 쿼리를 전송하면 08006 에러가 발생하며, 이는 진단이 까다로운 간헐적 장애로 나타나는 경우가 많습니다.

해결 방법

1. 현재 커넥션 상태 확인 및 유휴 커넥션 정리

서버의 커넥션 현황을 조회하여 문제가 있는 커넥션을 식별합니다.

-- 전체 커넥션 상태 확인
SELECT pid, usename, application_name, client_addr,
       state, wait_event_type, wait_event,
       now() - state_change AS idle_duration
FROM pg_stat_activity
ORDER BY idle_duration DESC NULLS LAST;

-- 5분 이상 유휴 상태인 커넥션 강제 종료
SELECT pg_terminate_backend(pid)
FROM pg_stat_activity
WHERE state = 'idle'
  AND state_change < now() - INTERVAL '5 minutes'
  AND pid <> pg_backend_pid();

-- 현재 max_connections 대비 사용 현황 확인
SELECT count(*) AS total_connections,
       max_conn,
       round(count(*) * 100.0 / max_conn, 2) AS usage_pct
FROM pg_stat_activity,
     (SELECT setting::int AS max_conn FROM pg_settings WHERE name = 'max_connections') AS mc
GROUP BY max_conn;

2. keepalive 및 연결 타임아웃 설정 조정

postgresql.conf 또는 클라이언트 연결 문자열에서 TCP keepalive 파라미터를 설정합니다.

-- postgresql.conf에서 keepalive 관련 설정 확인
SHOW tcp_keepalives_idle;
SHOW tcp_keepalives_interval;
SHOW tcp_keepalives_count;

-- 세션 레벨에서 keepalive 설정 (클라이언트 연결 직후 실행)
SET tcp_keepalives_idle = 60;       -- 60초 유휴 후 keepalive 시작
SET tcp_keepalives_interval = 10;   -- 10초마다 keepalive 패킷 전송
SET tcp_keepalives_count = 5;       -- 5회 실패 시 연결 종료

-- connection_timeout 설정 확인
SHOW statement_timeout;
SHOW idle_in_transaction_session_timeout;

-- idle_in_transaction_session_timeout 설정으로 좀비 트랜잭션 방지
-- postgresql.conf 또는 ALTER SYSTEM으로 적용
ALTER SYSTEM SET idle_in_transaction_session_timeout = '10min';
SELECT pg_reload_conf();

-- 적용 확인
SHOW idle_in_transaction_session_timeout;

3. max_connections 및 커넥션 풀 점검

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

-- 데이터베이스별 커넥션 제한 설정
ALTER DATABASE mydb CONNECTION LIMIT 100;

-- 특정 역할(Role)에 커넥션 제한 설정
ALTER ROLE app_user CONNECTION LIMIT 50;

-- 롤별, DB별 커넥션 현황 집계
SELECT datname, usename, count(*) AS conn_count
FROM pg_stat_activity
WHERE state IS NOT NULL
GROUP BY datname, usename
ORDER BY conn_count DESC;

PgBouncer와 같은 커넥션 풀러를 사용하는 경우, pgbouncer.ini에서 server_idle_timeout과 server_lifetime을 적절히 설정하여 만료된 커넥션이 재사용되지 않도록 합니다.

-- PgBouncer를 통한 연결 시 서버 커넥션 상태 확인 (PgBouncer SHOW 명령)
-- psql -p 6432 -U pgbouncer pgbouncer
-- SHOW pools;
-- SHOW servers;

-- PostgreSQL 서버에서 PgBouncer로부터 온 커넥션 확인
SELECT application_name, count(*)
FROM pg_stat_activity
WHERE application_name LIKE '%pgbouncer%'
GROUP BY application_name;

예방 방법

1. 커넥션 풀러(PgBouncer) 도입 및 헬스체크 설정

PgBouncer의 server_check_query와 server_check_delay 옵션을 활성화하면, 풀러가 주기적으로 커넥션 유효성을 검증하여 만료된 커넥션을 자동으로 교체합니다. 이를 통해 애플리케이션이 죽은 커넥션을 사용하는 상황을 원천 차단할 수 있으며, 동시에 max_connections 초과 문제도 완화할 수 있습니다.

-- 헬스체크용 경량 쿼리 예시 (애플리케이션 커넥션 풀 설정에서 사용)
SELECT 1;

-- 또는 pg_stat_activity를 통한 모니터링 쿼리
SELECT count(*) FROM pg_stat_activity WHERE state = 'active';

2. 자동 재연결 로직 및 모니터링 알림 체계 구축

애플리케이션 코드에서 08006 에러를 명시적으로 캐치하고 지수 백오프(exponential backoff) 방식의 재연결 로직을 구현해야 합니다. 또한 Prometheus + postgres_exporter를 활용하여 pg_stat_activity의 커넥션 수, 유휴 커넥션 비율, 에러 발생 빈도를 실시간으로 추적하고, 임계값 초과 시 즉시 알림을 받을 수 있는 체계를 갖추는 것이 운영 안정성을 크게 높여줍니다.

-- 모니터링을 위한 커넥션 상태 요약 뷰 생성 (운영 편의용)
CREATE OR REPLACE VIEW v_connection_summary AS
SELECT
    state,
    count(*) AS cnt,
    round(count(*) * 100.0 / sum(count(*)) OVER (), 2) AS pct
FROM pg_stat_activity
WHERE pid <> pg_backend_pid()
GROUP BY state
ORDER BY cnt DESC;

-- 사용 예시
SELECT * FROM v_connection_summary;