08001: sqlclient_unable_to_establish_sqlconnection

意味

クライアントが PostgreSQL サーバーへの接続を確立できなかった。セッションになる前に、ネットワーク/アドレスのレベルで接続が失敗した。

原因

誤ったホスト/ポート、サーバーがリッスンしていないアドレス (listen_addresses = 'localhost' の状態でリモートから接続)、サーバーの停止/到達不能、ファイアウォールによるポート (デフォルト 5432) のブロック、または DNS 名前解決の失敗。コネクションプールの設定誤りでも発生する。

対処方法

サーバーが起動しており正しいアドレスでリッスンしていることを確認する: postgresql.conf の listen_addresses = '*' (または該当 IP) と port の設定を確認し、サーバーを再起動する (listen_addresses と port は再起動が必要で、リロードでは不十分)。クライアントからアクセスをテストする: psql -h host -p 5432 -U app_user。ファイアウォールで 5432/tcp を開放する。host/port/DNS の値と接続文字列を見直す。