// Référence des erreurs PostgreSQL

PostgreSQL 25P03 : délai d'expiration d'une session inactive dans une transaction

La session est restée dans une transaction ouverte sans rien faire plus longtemps que idle_in_transaction_session_timeout, donc le serveur l'a fermée.

SQLSTATE
25P03
Nom
idle_in_transaction_session_timeout
Catégorie
État de transaction invalide
Message d'erreur
terminating connection due to idle-in-transaction timeout

Ce que cela signifie

Une session qui a démarré une transaction puis devient inactive est idle in transaction. Elle conserve encore ses verrous et empêche que les anciennes versions de lignes soient nettoyées par le vacuum. idle_in_transaction_session_timeout fait que le serveur met fin à ces sessions après un délai ; lorsque cela se produit, le client reçoit cette FATAL et la connexion est fermée, annulant la transaction.

La cause habituelle est un code applicatif qui ouvre une transaction puis attend autre chose, comme un appel réseau ou une entrée utilisateur, avant de valider.

Causes courantes

  • Du code qui effectue des opérations lentes (appels HTTP, traitement de fichiers) entre BEGIN et COMMIT.
  • Un client ou GUI avec autocommit désactivé, laissé ouvert après un SELECT, donc une transaction reste ouverte.
  • Un chemin d'exception qui ne valide ni n'annule jamais, laissant la connexion du pool inactive au milieu d'une transaction.

Comment le corriger

  1. Trouvez les sessions inactives dans une transaction et depuis combien de temps elles sont inactives.

    SELECT pid, usename, application_name, now() - state_change AS idle_for, query
    FROM pg_stat_activity
    WHERE state = 'idle in transaction'
    ORDER BY idle_for DESC;
  2. Effectuez un travail lent non lié à la base de données avant d'ouvrir la transaction ou après l'avoir validée, et validez ou annulez toujours dans un finally bloc.

  3. Gardez le délai d'expiration comme filet de sécurité ; définissez-le par rôle ou base de données si certains travaux ont légitimement besoin de plus de temps.

    ALTER ROLE app SET idle_in_transaction_session_timeout = '5min';

Erreurs liées

Plus d'erreurs d'état de transaction non valide

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.