PostgreSQL 08001: 연결을 설정할 수 없음
클라이언트가 서버에 연결을 전혀 열 수 없었습니다: 해당 호스트와 포트에서 수신 중인 서비스가 없거나, 방화벽, DNS 문제 또는 타임아웃이 원인일 수 있습니다.
- SQLSTATE
08001- 이름
sqlclient_unable_to_establish_sqlconnection- 카테고리
- 연결 예외
의미
08001은 클라이언트 측 SQLSTATE입니다. PgJDBC, Npgsql 같은 드라이버는 연결을 수립하지 못할 때 이 코드를 보고하고, libpq 기반 도구는 위와 같은 메시지를 출력합니다. 서버에는 로그인 시도조차 닿지 않았으므로 문제는 자격 증명이 아니라 네트워크 경로이거나 서버가 연결을 대기하고 있지 않은 것입니다.
맨 뒤의 운영 체제 오류가 어느 것인지 알려줍니다: Connection refused 호스트는 응답하지만 그 포트에서 수신 대기 중인 것이 없다는 뜻이며; timeout expired 또는 Operation timed out 보통 방화벽이 패킷을 차단했다는 뜻입니다; could not translate host name DNS입니다.
일반적인 원인
- PostgreSQL 서버가 실행 중이 아니거나 다른 포트에서 수신 대기 중입니다.
listen_addresses입니다localhost(기본값)으로 서버가 로컬 연결만 허용합니다.- 방화벽, 보안 그룹 또는 Docker 포트 매핑이 5432 포트를 차단합니다.
- 호스트 이름이 잘못되었거나 클라이언트에서 그 이름을 찾을 수 없는 경우입니다.
- 다음에 연결
localhost컨테이너 안에서 접속할 때 쓰는데, 이는 컨테이너 자체를 가리킵니다.
해결 방법
-
서버에서 PostgreSQL이 실행 중인지, 어떤 주소와 포트에서 수신 대기 중인지 확인하세요.
SHOW listen_addresses; SHOW port;
-
네트워크 연결 허용: 다음 설정
listen_addresses = '*'(또는 서버 주소)를postgresql.conf그리고 재시작한 뒤 다음을 추가합니다pg_hba.conf클라이언트를 위한 규칙입니다. -
클라이언트에서 네트워크 경로를 테스트합니다. 예를 들어
pg_isready -h db.example.com -p 5432, 그리고 방화벽이나 보안 그룹에서 포트를 여세요. -
컨테이너에서는 데이터베이스 컨테이너의 서비스 이름이나 호스트 주소로 연결합니다. 다음은 사용하지 마세요:
localhost.
관련 오류
08006연결 실패28000잘못된 인증 규격57P03지금 연결할 수 없음2003MySQL: 호스트의 MySQL 서버에 연결할 수 없음2002MySQL: 소켓을 통해 연결할 수 없음ORA-12541Oracle: TNS: 리스너가 없습니다
코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.
SQLly에서 PostgreSQL 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.