// Référence des erreurs PostgreSQL

PostgreSQL 53300 : trop de connexions

Le serveur a atteint max_connections et refuse de nouvelles sessions. Généralement, c'est une fuite de connexions ou des pools qui, ensemble, ouvrent plus de connexions qu'autorisé.

SQLSTATE
53300
Nom
too_many_connections
Catégorie
Ressources insuffisantes
Message d'erreur
sorry, too many clients already

Ce que cela signifie

PostgreSQL exécute un processus serveur par connexion et limite le total avec max_connections (100 par défaut). Quand chaque emplacement est pris, une nouvelle connexion échoue avec 53300 avant de pouvoir se connecter.

Quelques emplacements sont réservés aux superutilisateurs (superuser_reserved_connections, 3 par défaut) et, sur PostgreSQL 16 et versions ultérieures, pour les rôles dans pg_use_reserved_connections. Les rôles ordinaires voient alors remaining connection slots are reserved for roles with the SUPERUSER attribute (la formulation varie selon la version) avec le même code. Un rôle ou une base de données peut également avoir son propre CONNECTION LIMIT, ce qui échoue avec too many connections for role "app".

Causes courantes

  • Une application laisse fuir des connexions : elle les ouvre et ne les ferme jamais, ni ne les renvoie au pool.
  • Plusieurs instances d'application, chacune avec son propre pool, s'additionnent pour dépasser max_connections.
  • De nombreuses sessions restant idle in transaction, occupant des slots et des verrous.
  • Un pic de trafic, ou un travail qui ouvre une connexion par tâche.

Comment le corriger

  1. Voir qui est connecté et ce qu'il fait (se connecter en superutilisateur, qui peut toujours entrer).

    SELECT usename, application_name, client_addr, state, count(*)
    FROM pg_stat_activity
    GROUP BY 1, 2, 3, 4
    ORDER BY count(*) DESC;
  2. Terminer les sessions qui restent inactives dans une transaction ou qui appartiennent à un client incontrôlé.

    SELECT pg_terminate_backend(pid)
    FROM pg_stat_activity
    WHERE state = 'idle in transaction'
      AND state_change < now() - interval '10 minutes';
  3. Réparez la fuite ou réduisez les pools afin que leur total reste sous la limite, et mettez un pooler tel que PgBouncer devant de nombreux petits clients.

  4. Faites en sorte que le serveur termine automatiquement les sessions abandonnées.

    ALTER SYSTEM SET idle_in_transaction_session_timeout = '5min';
    SELECT pg_reload_conf();
  5. Augmenter max_connections Seulement si le serveur dispose de la mémoire nécessaire ; un redémarrage est nécessaire.

    ALTER SYSTEM SET max_connections = 200;  -- takes effect after restart

Questions

Combien de connexions PostgreSQL peut-il gérer ?

Le max_connections par défaut est de 100. Chaque connexion est un processus distinct avec sa propre mémoire, donc des centaines de connexions principalement inactives sont mieux gérées par un pooler de connexions plutôt que par un max_connections très élevé.

Erreurs liées

Plus d'erreurs de ressources insuffisantes

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.