// Référence des erreurs PostgreSQL

PostgreSQL 08001 : impossible d'établir la connexion

Le client n'a pas pu ouvrir une connexion au serveur : rien n'écoute sur cet hôte et ce port, un pare-feu, le DNS ou un délai d'attente.

SQLSTATE
08001
Nom
sqlclient_unable_to_establish_sqlconnection
Catégorie
Exception de connexion
Message d'erreur
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?

Ce que cela signifie

08001 est un SQLSTATE côté client : les pilotes tels que PgJDBC et Npgsql le signalent lorsqu'ils ne peuvent pas établir une connexion, et les outils basés sur libpq affichent des messages comme celui ci-dessus. Le serveur n'a jamais vu de tentative de connexion, donc le problème vient du chemin réseau ou du serveur qui n'écoute pas, pas des identifiants.

L'erreur du système d'exploitation à la fin indique laquelle : Connection refused signifie que l'hôte a répondu mais que rien n'écoute sur ce port ; timeout expired ou Operation timed out signifie généralement qu'un pare-feu a bloqué les paquets ; could not translate host name c'est le DNS.

Causes courantes

  • Le serveur PostgreSQL n'est pas en cours d'exécution, ou écoute sur un autre port.
  • listen_addresses est localhost (par défaut), donc le serveur n'accepte que les connexions locales.
  • Un pare-feu, un groupe de sécurité ou un mappage de port Docker bloque le port 5432.
  • Nom d'hôte incorrect, ou un nom d'hôte qui ne se résout pas depuis le client.
  • Se connecter à localhost depuis l'intérieur d'un conteneur, ce qui fait référence au conteneur lui-même.

Comment le corriger

  1. Sur le serveur, vérifiez que PostgreSQL fonctionne et quelles adresses et quel port il écoute.

    SHOW listen_addresses;
    SHOW port;
  2. Autoriser les connexions réseau : définir listen_addresses = '*' (ou l'adresse du serveur) dans postgresql.conf et redémarrez, puis ajoutez une pg_hba.conf règle pour les clients.

  3. Testez le chemin réseau depuis le client, par exemple pg_isready -h db.example.com -p 5432, et ouvrez le port dans le pare-feu ou le groupe de sécurité.

  4. Depuis un conteneur, connectez-vous au nom du service du conteneur de base de données ou à l'adresse de l'hôte au lieu de localhost.

Erreurs liées

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.