Um deadlock é um ciclo de espera no qual dois ou mais processos retêm recursos necessários uns aos outros e nenhum consegue avançar. Em bancos de dados, isso pode ocorrer quando transações adquirem travas sobre registros em ordens diferentes.
Duas transações e dois registros
Como exemplo didático, a transação T1 altera o registro A e mantém sua trava até terminar. Ao mesmo tempo, T2 altera B e mantém a trava desse registro. Quando T1 tenta alterar B, precisa aguardar T2. Se T2 tentar alterar A, também terá de esperar por T1.
O ciclo está formado porque cada transação depende de um recurso retido pela outra. Uma espera isolada por um registro não caracteriza deadlock: a transação que mantém a trava pode concluir e liberar o recurso, pois não aguarda nenhum recurso da transação que está esperando.
O tratamento no PostgreSQL
O PostgreSQL detecta o deadlock e aborta uma das transações envolvidas. As alterações dessa transação são desfeitas e suas travas são liberadas, permitindo que as demais prossigam. A documentação orienta não depender da escolha da transação que será cancelada.
Você precisa tratar o erro recebido pela aplicação. Uma nova tentativa deve repetir a transação completa, pois a falha desfez o trabalho daquela tentativa. Efeitos externos, como um email já enviado, exigem tratamento próprio porque o rollback do banco não os desfaz.
A documentação recomenda adquirir travas sobre os mesmos recursos em uma ordem consistente. No exemplo, fazer as duas transações acessarem A antes de B evita aquele ciclo específico. Manter transações curtas também reduz o tempo de retenção das travas, mas a aplicação ainda precisa estar preparada para tratar deadlocks.
Dúvidas frequentes
Perguntas frequentes sobre deadlock
- Toda espera por uma trava é um deadlock?
- Uma transação pode aguardar a liberação de um recurso sem formar um ciclo. No deadlock, existe uma dependência circular que impede o avanço das transações envolvidas.
- É possível prever qual transação o PostgreSQL vai cancelar?
- A documentação orienta não depender dessa escolha. O PostgreSQL detecta o ciclo e aborta uma das transações envolvidas para permitir que as outras prossigam.
- A aplicação pode repetir somente a última consulta?
- Depois de um deadlock, a transação abortada precisa ser repetida como um todo quando a aplicação tentar novamente. Reavalie também efeitos externos, como uma mensagem já enviada, para evitar duplicação.
Para continuar
Recursos relacionados
Documentação
PostgreSQL: deadlocks
Travas e deadlocks no PostgreSQL, com exemplo de atualizações concorrentes e orientação para evitar ciclos.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação técnica ao vivo para investigar transações concorrentes e revisar o tratamento de deadlocks no código.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Aplicações criadas com agentes precisam tratar falhas de concorrência e repetir transações sem duplicar efeitos externos.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.