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
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 NOWAIToLOCK TABLE ... NOWAITse topó con una fila o una tabla que otra transacción tiene bloqueada.- A
lock_timeoutcaducado, normalmente en DDL comoALTER 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
-
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 ); -
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;
-
Para cambios de esquema, usa un corto
lock_timeoutdeliberadamente y reintenta, para que elALTERno 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;
-
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
40P01se detectó un interbloqueo57014cancelando instrucción55006objeto en uso1222SQL Server: Se superó el tiempo de espera de la solicitud de bloqueo1205MySQL: se superó el tiempo de espera de bloqueo3572MySQL: no se pudo obtener el bloqueo con NOWAITORA-00054Oracle: recurso ocupado y adquisición con NOWAIT especificadoSQLITE_BUSYSQLite: la base de datos está bloqueada
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.
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.