PostgreSQL 25P03: tiempo de espera de sesión inactiva en transacción
La sesión estuvo dentro de una transacción abierta sin hacer nada más tiempo del permitido por idle_in_transaction_session_timeout, así que el servidor la cerró.
- SQLSTATE
25P03- Nombre
idle_in_transaction_session_timeout- Categoría
- Estado de transacción no válido
Qué significa
Una sesión que ha iniciado una transacción y luego se queda en silencio es idle in transaction. Todavía conserva sus bloqueos y evita que el vacuum purgue las versiones antiguas de las filas. idle_in_transaction_session_timeout hace que el servidor termine dichas sesiones tras un límite de tiempo; cuando ocurre, el cliente recibe este FATAL error y la conexión se cierra, revertiendo la transacción.
La causa raíz habitual es código de la aplicación que abre una transacción y luego espera otra cosa, como una llamada de red o la entrada del usuario, antes de hacer commit.
Causas comunes
- Código que realiza trabajo lento (llamadas HTTP, procesamiento de archivos) entre
BEGINyCOMMIT. - Un cliente o GUI con el autocommit desactivado, que se quedó abierto después de un
SELECT, por lo que una transacción permanece abierta. - Una ruta de excepción que nunca confirma ni revierte, dejando la conexión en el pool inactiva en una transacción.
Cómo solucionarlo
-
Encuentra las sesiones inactivas dentro de una transacción y cuánto tiempo llevan inactivas.
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;
-
Realiza trabajos lentos que no sean de base de datos antes de abrir la transacción o después de confirmarla, y siempre confirma o revierte en un
finallybloque. -
Mantén el tiempo de espera como red de seguridad; configúralo por rol o base de datos si algún trabajo necesita de verdad más tiempo.
ALTER ROLE app SET idle_in_transaction_session_timeout = '5min';
Errores relacionados
57P01terminando conexión debido a administrador53300demasiadas conexiones55P03bloqueo no disponible08006fallo de conexión
Más errores de estado de transacción no válido
25001no se puede ejecutar dentro de un bloque de transacción25006transacción SQL de solo lectura25P02la transacción actual está abortada
El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.
Trabajar con PostgreSQL en SQLly
Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.