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
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
BEGINetCOMMIT. - 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
-
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;
-
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
finallybloc. -
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
57P01connexion interrompue par l'administrateur53300trop de connexions55P03verrou non disponible08006échec de connexion
Plus d'erreurs d'état de transaction non valide
25001impossible d'exécuter dans un bloc de transaction25006Transaction SQL en lecture seule25P02la transaction en cours est annulée
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.
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.