// Referencia de errores de PostgreSQL

PostgreSQL 40P01: se detectó un interbloqueo

Dos o más transacciones se estaban esperando mutuamente por sus bloqueos. PostgreSQL revirtió una para que la otra pudiera terminar; reintenta la que falló.

SQLSTATE
40P01
Nombre
deadlock_detected
Categoría
Reversión de transacción
Mensaje de error
deadlock detected
DETAIL:  Process 1234 waits for ShareLock on transaction 5678; blocked by process 4321.
Process 4321 waits for ShareLock on transaction 8765; blocked by process 1234.

Qué significa

Un interbloqueo es un ciclo de esperas de bloqueo: la transacción A mantiene un bloqueo que B necesita mientras espera otro que B mantiene. Ninguna puede avanzar, así que cuando una espera de bloqueo dura deadlock_timeout (1 segundo por defecto) PostgreSQL comprueba si hay un ciclo y, si lo hay, aborta una de las transacciones con 40P01.

La transacción abortada se revierte por completo. La otra sigue adelante. Las DETAIL líneas muestran qué procesos estaban involucrados y la CONTEXT línea qué instrucción estaba esperando.

Causas comunes

  • Dos transacciones actualizan las mismas filas en distinto orden; por ejemplo, una transfiere dinero de la cuenta 1 a la 2 y la otra de la 2 a la 1.
  • Claves foráneas: insertar filas hijas toma un FOR KEY SHARE bloqueo en la fila padre, lo que puede entrar en conflicto con otra transacción que esté actualizando ese padre.
  • Transacciones largas que afectan muchas filas, lo que amplía la ventana para un conflicto de orden de bloqueo.
  • Explícito LOCK TABLE o SELECT ... FOR UPDATE tomado en distinto orden en distintas rutas de código.

Cómo solucionarlo

  1. Reintenta la transacción fallida. Un interbloqueo es un resultado normal de la concurrencia, y la aplicación debe capturar SQLSTATE 40P01 (y 40001) y ejecutar toda la transacción de nuevo.

  2. Adquiere los bloqueos en el mismo orden en todas partes; por ejemplo, bloquea siempre el id más bajo primero.

    BEGIN;
    SELECT * FROM accounts WHERE id IN (1, 2) ORDER BY id FOR UPDATE;
    UPDATE accounts SET balance = balance - 100 WHERE id = 1;
    UPDATE accounts SET balance = balance + 100 WHERE id = 2;
    COMMIT;
  3. Mantén cortas las transacciones: haz primero las lecturas y los cálculos, luego las escrituras, y confirma rápidamente.

  4. Activar log_lock_waits de modo que las esperas de más de deadlock_timeout se registran junto con las instrucciones implicadas; luego mira el registro del servidor.

    ALTER SYSTEM SET log_lock_waits = on;
    SELECT pg_reload_conf();

Reprodúcelo de forma segura

Ejecuta los pasos en dos conexiones separadas, en orden, en una base de datos de prueba.

-- Session 1:
CREATE TABLE dl (id int PRIMARY KEY, v int);
INSERT INTO dl VALUES (1, 0), (2, 0);
BEGIN; UPDATE dl SET v = 1 WHERE id = 1;
-- Session 2:
BEGIN; UPDATE dl SET v = 2 WHERE id = 2;
UPDATE dl SET v = 2 WHERE id = 1;   -- waits
-- Session 1:
UPDATE dl SET v = 1 WHERE id = 2;   -- one session gets ERROR: deadlock detected

Preguntas

¿Qué transacción aborta PostgreSQL en un interbloqueo?

La que detectó el ciclo en su comprobación de interbloqueo, algo que en general no es predecible. Escribe cada transacción de forma que se pueda reintentar.

Errores relacionados

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.