// Referencia de errores de PostgreSQL

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
Mensaje de error
terminating connection due to idle-in-transaction timeout

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 BEGIN y COMMIT.
  • 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

  1. 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;
  2. 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 finally bloque.

  3. 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

Más errores de estado de transacción no válido

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.

// menos errores, correcciones más rápidas

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.