// Referência de erro do PostgreSQL

PostgreSQL 40P01: deadlock detectado

Duas ou mais transações estavam esperando pelos bloqueios umas das outras. O PostgreSQL reverteu uma para que a outra pudesse terminar; tente novamente a que falhou.

SQLSTATE
40P01
Nome
deadlock_detected
Categoria
Rollback de Transação
Mensagem de erro
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.

O que significa

Um deadlock é um ciclo de espera por bloqueios: a transação A mantém um bloqueio que B precisa enquanto espera por um bloqueio que B mantém. Nenhuma das duas pode prosseguir, então quando uma espera por bloqueio dura deadlock_timeout (1 segundo por padrão) o PostgreSQL verifica se há um ciclo e, se encontrar, aborta uma das transações com 40P01.

A transação abortada é revertida por completo. A outra segue em frente. O DETAIL linhas mostram quais processos estavam envolvidos e a CONTEXT linha qual instrução estava esperando.

Causas comuns

  • Duas transações atualizam as mesmas linhas em uma ordem diferente, por exemplo, uma transfere dinheiro da conta 1 para a 2 enquanto outra vai da 2 para a 1.
  • Chaves estrangeiras: inserir linhas filhas exige um FOR KEY SHARE bloqueio na linha pai, o que pode entrar em conflito com outra transação que está atualizando esse pai.
  • Transações longas que tocam muitas linhas, o que abre janela para ordens de bloqueio sobrepostas.
  • Explícito LOCK TABLE ou SELECT ... FOR UPDATE tomado em ordens diferentes em caminhos de código diferentes.

Como corrigir

  1. Tente novamente a transação que falhou. Um deadlock é um resultado normal de concorrência, e o aplicativo deve capturar SQLSTATE 40P01 (e 40001) e executar toda a transação novamente.

  2. Adquira os bloqueios sempre na mesma ordem, por exemplo, bloqueie sempre o id menor primeiro.

    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. Mantenha as transações curtas: faça primeiro as leituras e os cálculos, depois as gravações, e faça o commit rapidamente.

  4. Ativar log_lock_waits então esperas maiores que deadlock_timeout são registradas junto com as instruções envolvidas, e depois veja o log do servidor.

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

Reproduza com segurança

Execute os passos em duas conexões separadas, em ordem, em um banco de dados descartável.

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

Perguntas

Qual transação o PostgreSQL aborta em um deadlock?

Aquela cuja verificação de deadlock encontrou o ciclo, o que não é previsível em geral. Escreva cada transação de modo que possa ser tentada novamente.

Erros relacionados

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.