// PostgreSQL エラーリファレンス

PostgreSQL 08001: 接続を確立できません

クライアントは、サーバーへの接続をまったく開けませんでした。そのホストとポートで待ち受けているものがない、ファイアウォール、DNS、またはタイムアウトが原因として考えられます。

SQLSTATE
08001
名前
sqlclient_unable_to_establish_sqlconnection
カテゴリ
接続例外
エラーメッセージ
connection to server at "db.example.com" (10.0.0.5), port 5432 failed: Connection refused
	Is the server running on that host and accepting TCP/IP connections?

意味

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 コンテナ内部から。これはコンテナ自体を指します。

修正方法

  1. サーバー上で、PostgreSQL が実行されていること、およびどのアドレスとポートで待ち受けているかを確認します。

    SHOW listen_addresses;
    SHOW port;
  2. ネットワーク接続を許可するには、次を設定: listen_addresses = '*' (またはサーバーのアドレス) postgresql.conf 、再起動してから追加します pg_hba.conf クライアント向けのルール。

  3. クライアントからのネットワークパスをテストします。たとえば pg_isready -h db.example.com -p 5432、ファイアウォールまたはセキュリティグループでポートを開放してください。

  4. コンテナからは、データベースコンテナのサービス名またはホストのアドレスに接続します。次は使わないでください: localhost.

関連エラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。