08001: sqlclient_unable_to_establish_sqlconnection

의미

클라이언트가 PostgreSQL 서버에 연결을 수립하지 못했다. 연결이 세션이 되기 전에 네트워크/주소 수준에서 실패했다.

원인

잘못된 host/port, 서버가 수신하지 않는 주소(listen_addresses = 'localhost'인데 원격 접속), 서버 다운/접근 불가, 방화벽의 포트 차단(기본 5432), DNS 해석 실패가 원인이다. 잘못 구성된 커넥션 풀도 원인이 될 수 있다.

해결 방법

서버가 실행 중이고 올바른 주소에서 수신하는지 확인한다: postgresql.conf의 listen_addresses = '*'(또는 해당 IP)와 port 설정을 확인한 후 서버를 재시작한다(listen_addresses와 port는 재시작이 필요하며 reload로는 부족하다). 클라이언트에서 접근 테스트: psql -h host -p 5432 -U app_user. 방화벽에서 5432/tcp를 연다. host/port/DNS 값과 연결 문자열을 검토한다.