Digite para filtrar os verbetes do Glossário.

    Banco de dados · Vibe Coding: Do Zero ao MVP

    O que é deadlock?

    Um deadlock ocorre quando transações aguardam recursos retidos umas pelas outras. O PostgreSQL desfaz uma delas para interromper o ciclo de espera.

    Também chamado de: impasse entre transações, espera circular

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano