// Referência de erro do PostgreSQL

PostgreSQL 55P03: bloqueio não disponível

Um pedido de bloqueio desistiu de esperar: foi usado NOWAIT, ou o lock_timeout venceu enquanto outra sessão segurava um bloqueio conflitante.

SQLSTATE
55P03
Nome
lock_not_available
Categoria
O objeto não está no estado de pré-requisito
Mensagem de erro
could not obtain lock on row in relation "orders"

O que significa

Normalmente, o PostgreSQL espera o tempo necessário por um bloqueio. 55P03 significa que a instrução recebeu ordem para não: SELECT ... FOR UPDATE NOWAIT ou LOCK TABLE ... NOWAIT falhar imediatamente se o bloqueio estiver ocupado, e quando lock_timeout está definido, qualquer instrução falha depois de esperar esse tempo. Um timeout de bloqueio reporta canceling statement due to lock timeout com o mesmo código.

A outra sessão que mantém o bloqueio não é afetada. Dentro de um bloco de transação, a instrução que falhou aborta a transação.

Causas comuns

  • FOR UPDATE NOWAIT, FOR SHARE NOWAIT ou LOCK TABLE ... NOWAIT encontrou uma linha ou tabela que outra transação bloqueou.
  • A lock_timeout expirado, tipicamente em DDL como ALTER TABLE, que precisa de um bloqueio exclusivo e espera atrás de consultas de longa duração.
  • Uma transação longa, ou uma sessão deixada ociosa dentro de uma transação que segura bloqueios.

Como corrigir

  1. Encontre a sessão que detém o bloqueio.

    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 filas de tarefas, pule linhas bloqueadas em vez de dar erro.

    SELECT id FROM jobs
    WHERE status = 'queued'
    ORDER BY id
    LIMIT 10
    FOR UPDATE SKIP LOCKED;
  3. Para alterações de esquema, use um curto lock_timeout deliberadamente e tente novamente, para que o ALTER não entra na fila atrás de uma consulta longa e bloqueia todo mundo.

    SET lock_timeout = '3s';
    ALTER TABLE orders ADD COLUMN note text;
  4. Encerre ou encurte a transação bloqueante; se ela estiver abandonada, finalize-a.

    SELECT pg_terminate_backend(12345);  -- the blocking pid

Reproduza com segurança

Execute em duas conexões; encerre a sessão 1 com ROLLBACK depois.

-- 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"

Erros relacionados

Mais erros de objeto fora do estado pré-requisito

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.