// Referencia de errores de PostgreSQL

PostgreSQL 25P02: la transacción actual está abortada

Una instrucción anterior de esta transacción falló, así que PostgreSQL rechaza todo lo demás hasta que hagas ROLLBACK (o vuelvas a un punto de guardado).

SQLSTATE
25P02
Nombre
in_failed_sql_transaction
Categoría
Estado de transacción no válido
Mensaje de error
current transaction is aborted, commands ignored until end of transaction block

Qué significa

En PostgreSQL, cualquier error dentro de un bloque de transacción pone toda la transacción en estado fallido. A partir de ahí, todas las instrucciones, excepto ROLLBACK (o ROLLBACK TO SAVEPOINT) falla con 25P02 sin llegar a ejecutarse. COMMIT en una transacción fallida no se confirma; termina la transacción e informa ROLLBACK.

25P02 nunca es el problema real. Es el eco de un error que ocurrió anteriormente en la misma transacción.

Causas comunes

  • Una instrucción falló antes en la transacción (una violación de restricción, un error tipográfico, un cast incorrecto) y el código siguió adelante sin hacer rollback.
  • Una aplicación captura una excepción de una consulta y reutiliza la misma conexión, todavía dentro de la transacción fallida.
  • Un grupo de conexiones entrega una conexión que su usuario anterior dejó en una transacción fallida.

Cómo solucionarlo

  1. Busca el primer error en la transacción, en el registro de tu aplicación o en el registro del servidor, y corrígelo.

  2. Termina la transacción fallida con ROLLBACK, luego comienza de nuevo.

    ROLLBACK;
  3. Si algunas instrucciones pueden fallar sin perder el resto de la transacción, envuelve cada una en un savepoint.

    BEGIN;
    INSERT INTO audit_log (msg) VALUES ('start');
    SAVEPOINT try_insert;
    INSERT INTO users (id, email) VALUES (1, '[email protected]');  -- may fail
    -- on error:
    ROLLBACK TO SAVEPOINT try_insert;
    COMMIT;  -- audit_log row is kept
  4. En psql, \set ON_ERROR_ROLLBACK interactive hace que psql establezca un punto de guardado implícito antes de cada instrucción, para que un error tipográfico no aborte una transacción interactiva.

Reprodúcelo de forma segura

BEGIN;
SELECT 1/0;          -- ERROR: division by zero
SELECT 1;            -- ERROR: current transaction is aborted ...
ROLLBACK;

Preguntas

¿Por qué COMMIT dice ROLLBACK?

La transacción ya había fallado, así que no hay nada válido que confirmar. PostgreSQL la termina e informa ROLLBACK para que quede claro.

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.