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

08004 sqlserver rejected establishment of sqlconnection 는?

PostgreSQL 에러 코드 08004는 클라이언트가 데이터베이스 서버에 연결을 시도했으나, 서버 측에서 해당 연결 요청을 명시적으로 거부한 경우에 발생합니다. 이 에러는 인증 실패, 접근 권한 부족, 최대 연결 수 초과, 또는 pg_hba.conf 설정 불일치 등 다양한 원인으로 발생할 수 있습니다. 일반적으로 애플리케이션 배포 초기나 서버 설정 변경 이후에 자주 나타나며, 빠른 원인 파악과 대처가 중요합니다.

---

주요 발생 원인

1. pg_hba.conf 접근 제어 설정 오류

pg_hba.conf 파일은 PostgreSQL의 클라이언트 인증을 제어하는 핵심 설정 파일입니다. 클라이언트의 IP 주소, 데이터베이스명, 사용자명이 pg_hba.conf에 정의된 규칙과 일치하지 않으면 서버는 연결을 즉시 거부합니다. 예를 들어, 특정 IP 대역에서의 접속을 허용하지 않거나 인증 방식(md5, scram-sha-256, trust 등)이 맞지 않을 경우 이 에러가 발생합니다. 실무에서는 신규 서버 IP 추가나 네트워크 변경 후 이 파일을 업데이트하지 않아 발생하는 경우가 매우 흔합니다.

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

PostgreSQL 서버는 max_connections 파라미터로 허용하는 최대 동시 연결 수가 제한되어 있습니다. 이 한도를 초과하면 새로운 연결 시도는 서버에 의해 즉시 거부되며 08004 에러가 발생합니다. 특히 트래픽이 급증하는 상황이나 커넥션 풀 설정이 제대로 되어 있지 않은 경우, 또는 좀비 연결(idle connection)이 누적된 경우에 빈번하게 나타납니다. 이 문제는 단순히 max_connections 값을 올리는 것만으로는 해결되지 않으며, PgBouncer와 같은 커넥션 풀러 도입이 함께 권장됩니다.

3. 데이터베이스 또는 사용자 권한 부족

특정 데이터베이스에 접속하려는 사용자가 해당 데이터베이스에 대한 CONNECT 권한을 가지고 있지 않은 경우에도 연결이 거부됩니다. PostgreSQL은 기본적으로 PUBLIC 역할에 CONNECT 권한을 부여하지만, 보안 강화를 위해 이를 명시적으로 취소한 환경에서는 사용자별로 권한을 다시 부여해야 합니다. 또한, 해당 사용자 계정이 잠겨 있거나(LOGIN 속성 없음), 역할 자체가 비활성화된 경우에도 동일한 에러가 발생할 수 있습니다.

---

해결 방법

원인 1: pg_hba.conf 설정 수정

현재 pg_hba.conf 파일을 확인하고 필요한 항목을 추가하거나 수정합니다.

-- 현재 pg_hba.conf 파일 위치 확인
SHOW hba_file;

-- pg_hba.conf 파일 내 설정 예시 (파일을 직접 편집해야 함)
-- 형식: TYPE  DATABASE  USER  ADDRESS  METHOD
-- 특정 IP에서 특정 사용자가 특정 DB에 접속 허용
-- host    mydb    myuser    192.168.1.100/32    scram-sha-256

-- 특정 서브넷 전체 허용
-- host    all    all    10.0.0.0/8    md5

-- 설정 변경 후 서버 재로드 (재시작 없이 적용 가능)
SELECT pg_reload_conf();

-- 현재 적용된 pg_hba 설정 확인 (PostgreSQL 10 이상)
SELECT type, database, user_name, address, auth_method
FROM pg_hba_file_rules;

파일 수정 후에는 반드시 pg_reload_conf()를 실행하거나 pg_ctl reload 명령어로 설정을 재적용해야 합니다.

---

원인 2: 최대 연결 수 확인 및 조정

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

-- 현재 연결 수 및 상태 확인
SELECT count(*), state
FROM pg_stat_activity
GROUP BY state
ORDER BY count(*) DESC;

-- 유휴 연결 목록 확인 (idle 상태가 너무 많은 경우)
SELECT pid, usename, application_name, client_addr, state, state_change
FROM pg_stat_activity
WHERE state = 'idle'
ORDER BY state_change;

-- 특정 유휴 연결 강제 종료 (주의: 업무 영향 확인 후 실행)
SELECT pg_terminate_backend(pid)
FROM pg_stat_activity
WHERE state = 'idle'
  AND state_change < NOW() - INTERVAL '10 minutes';

-- max_connections 값 임시 변경 (재시작 필요)
-- postgresql.conf에서 수정하거나 아래 명령어 사용
ALTER SYSTEM SET max_connections = 300;

-- 변경 사항 확인 후 PostgreSQL 재시작 필요
-- pg_ctl restart 또는 systemctl restart postgresql

> ⚠️ max_connections를 무작정 늘리면 메모리 소모가 급격히 증가합니다. 연결당 약 5~10MB의 메모리를 사용하므로, PgBouncer 등의 커넥션 풀러 도입을 적극 검토하세요.

---

원인 3: 사용자 권한 및 로그인 속성 확인

-- 사용자의 로그인 가능 여부 확인
SELECT rolname, rolcanlogin, rolconnlimit
FROM pg_roles
WHERE rolname = 'myuser';

-- 데이터베이스의 연결 권한 확인
SELECT has_database_privilege('myuser', 'mydb', 'CONNECT');

-- CONNECT 권한 부여
GRANT CONNECT ON DATABASE mydb TO myuser;

-- 로그인 권한이 없는 경우 활성화
ALTER ROLE myuser LOGIN;

-- 연결 제한이 걸려있는 경우 해제 (-1은 무제한)
ALTER ROLE myuser CONNECTION LIMIT -1;

-- PUBLIC 역할에서 CONNECT 권한이 취소된 경우
-- 특정 사용자에게 명시적으로 권한 부여
REVOKE CONNECT ON DATABASE mydb FROM PUBLIC;
GRANT CONNECT ON DATABASE mydb TO myuser;

-- 역할 속성 종합 확인
\du myuser  -- psql 클라이언트에서 사용
-- 또는
SELECT * FROM pg_roles WHERE rolname = 'myuser';

---

예방 방법

1. 연결 모니터링 및 알람 체계 구축

운영 환경에서는 현재 연결 수가 max_connections의 80%를 초과하면 즉시 알람이 발생하도록 모니터링 시스템을 구성해야 합니다. Prometheus + pg_exporter, Datadog, Zabbix 등의 도구를 활용하면 연결 수, 유휴 연결, 연결 대기 상태 등을 실시간으로 추적할 수 있습니다. 이를 통해 08004 에러가 실제로 발생하기 전에 선제적으로 대응할 수 있습니다.

-- 연결 사용률 모니터링 쿼리 (임계값 80% 기준)
SELECT
    current_setting('max_connections')::int AS max_conn,
    count(*) AS current_conn,
    round(count(*) * 100.0 / current_setting('max_connections')::int, 2) AS usage_pct
FROM pg_stat_activity;

2. 커넥션 풀러(PgBouncer) 필수 도입

애플리케이션 서버가 PostgreSQL에 직접 연결하는 구조는 연결 수 폭증에 매우 취약합니다. PgBouncer를 중간 레이어로 두면, 다수의 애플리케이션 연결을 소수의 실제 DB 연결로 압축하여 관리할 수 있습니다. Transaction 모드의 PgBouncer를 사용할 경우 수천 개의 클라이언트 연결을 수십 개의 DB 연결로 처리할 수 있어 08004 에러를 구조적으로 예방할 수 있습니다.

---

관련 에러

• 08000 (connection_exception): 연결 과정 중 일반적인 예외 상황 발생 시 나타나는 상위 에러 코드입니다.
• 08001 (sqlclient_unable_to_establish_sqlconnection): 클라이언트 측에서 연결 자체를 수립하지 못한 경우로, 08004와 반대로 클라이언트 원인인 경우가 많습니다.
• 08006 (connection_failure): 이미 수립된 연결이 통신 중 끊어진 경우 발생하며, 네트워크 불안정이 주원인입니다.
• 28000 (invalid_authorization_specification): 인증 정보(사용자명/비밀번호)가 올바르지 않을 때 발생하며, 08004와 혼동되기 쉬운 에러입니다.
• 53300 (too_many_connections): max_connections 초과 시 발생하는 에러로, 08004의 원인 중 하나인 최대 연결 초과와 밀접하게 연관되어 있습니다.

---

본 포스트는 AI가 생성한 기술 가이드입니다. 운영 환경 적용 전 충분한 검토를 권장합니다.