// Référence des erreurs PostgreSQL

PostgreSQL 08006 : échec de connexion

La connexion au serveur a été interrompue pendant l'utilisation. Le processus serveur s'est terminé, a redémarré ou a été tué, ou le réseau a abandonné une connexion inactive.

SQLSTATE
08006
Nom
connection_failure
Catégorie
Exception de connexion
Message d'erreur
server closed the connection unexpectedly
	This probably means the server terminated abnormally
	before or while processing the request.

Ce que cela signifie

08006 est un code côté client : les pilotes le signalent lorsqu'une connexion établie échoue en cours de conversation. Le serveur ne peut pas envoyer d'erreur sur une connexion qui ne fonctionne plus, donc le message provient de la bibliothèque client. Les outils basés sur libpq (psql, psycopg) affichent le message ci-dessus, et PgJDBC signale SQLSTATE 08006 avec An I/O error occurred while sending to the backend.

Le journal du serveur l'explique généralement : un crash et un redémarrage du backend, un arrêt faute de mémoire, un administrateur qui a terminé la session, ou rien du tout lorsqu'un pare-feu ou un équilibreur de charge a discrètement coupé une connexion TCP inactive.

Causes courantes

  • Le processus serveur de la session a planté ou a été tué, souvent par le OOM killer du système d'exploitation, ce qui pousse PostgreSQL à redémarrer toutes les sessions.
  • Le serveur a été redémarré ou a subi un basculement.
  • Un pare-feu, une passerelle NAT ou un équilibreur de charge cloud a coupé une connexion inactive plus longtemps que son délai d'expiration.
  • La session a été terminée par pg_terminate_backend() ou un délai d'inactivité, et le client ne l'a remarqué qu'à sa prochaine requête.

Comment le corriger

  1. Vérifiez le journal du serveur autour du moment de l'échec pour terminated by signal, server process ... was terminated, ou un redémarrage.

  2. Si une connexion inactive a été interrompue par le réseau, activez les keepalives TCP sur le serveur (ou le client) afin que la connexion ne semble jamais inactive.

    ALTER SYSTEM SET tcp_keepalives_idle = 60;
    ALTER SYSTEM SET tcp_keepalives_interval = 10;
    ALTER SYSTEM SET tcp_keepalives_count = 6;
    SELECT pg_reload_conf();
  3. Configurez le pool de connexions pour valider ou recycler les connexions avant de les attribuer, et réessayer l'opération une fois sur une nouvelle connexion lorsque cela est sans risque.

  4. Si le serveur a manqué de mémoire, trouvez la requête qui l'a utilisée et réduisez work_mem ou le nombre de connexions simultanées.

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.