// Referencia de errores de PostgreSQL

PostgreSQL 55P03: bloqueo no disponible

Una solicitud de bloqueo renunció a esperar: se usó NOWAIT, o lock_timeout expiró mientras otra sesión mantenía un bloqueo en conflicto.

SQLSTATE
55P03
Nombre
lock_not_available
Categoría
El objeto no está en el estado de prerrequisito
Mensaje de error
could not obtain lock on row in relation "orders"

Qué significa

Normalmente, PostgreSQL espera lo que haga falta para conseguir un bloqueo. 55P03 significa que a la instrucción se le dijo que no lo hiciera: SELECT ... FOR UPDATE NOWAIT o LOCK TABLE ... NOWAIT fallar de inmediato si el bloqueo ya está tomado, y cuando lock_timeout está establecido, cualquier instrucción falla una vez que ha esperado ese tiempo. Un tiempo de espera de bloqueo informa canceling statement due to lock timeout con el mismo código.

La otra sesión que mantiene el bloqueo no se ve afectada. Dentro de un bloque de transacción, la instrucción fallida aborta la transacción.

Causas comunes

  • FOR UPDATE NOWAIT, FOR SHARE NOWAIT o LOCK TABLE ... NOWAIT se topó con una fila o una tabla que otra transacción tiene bloqueada.
  • A lock_timeout caducado, normalmente en DDL como ALTER TABLE, que necesita un bloqueo exclusivo y espera detrás de consultas de larga duración.
  • Una transacción larga o una sesión inactiva dentro de una transacción que retiene bloqueos.

Cómo solucionarlo

  1. Encuentra la sesión que mantiene el bloqueo.

    SELECT pid, usename, state, xact_start, query
    FROM pg_stat_activity
    WHERE pid IN (
        SELECT unnest(pg_blocking_pids(pid)) FROM pg_stat_activity
    );
  2. Para colas de trabajos, omite las filas bloqueadas en lugar de fallar.

    SELECT id FROM jobs
    WHERE status = 'queued'
    ORDER BY id
    LIMIT 10
    FOR UPDATE SKIP LOCKED;
  3. Para cambios de esquema, usa un corto lock_timeout deliberadamente y reintenta, para que el ALTER no se ponga en cola detrás de una consulta larga y bloquee a todos los demás.

    SET lock_timeout = '3s';
    ALTER TABLE orders ADD COLUMN note text;
  4. Finaliza o acorta la transacción que bloquea; si está abandonada, termínala.

    SELECT pg_terminate_backend(12345);  -- the blocking pid

Reprodúcelo de forma segura

Ejecuta en dos conexiones; termina la sesión 1 con ROLLBACK después.

-- Session 1:
CREATE TABLE q (id int PRIMARY KEY);
INSERT INTO q VALUES (1);
BEGIN; SELECT * FROM q WHERE id = 1 FOR UPDATE;
-- Session 2:
SELECT * FROM q WHERE id = 1 FOR UPDATE NOWAIT;  -- ERROR: could not obtain lock on row in relation "q"

Errores relacionados

Más errores de objeto no en el estado previo

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.