...
Eroare System Design · Baza de date: conexiuni, lock-uri, interogări lente

ERROR: deadlock detected

Pe scurt

Două (sau mai multe) tranzacții așteaptă una după alta lock-uri pe care le țin reciproc, așa că PostgreSQL anulează una dintre ele. Cauza tipică e ordinea diferită de blocare a acelorași rânduri. Ia lock-urile mereu în aceeași ordine, ține tranzacțiile scurte și reîncearcă tranzacția anulată.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

PostgreSQL verifică periodic (după deadlock_timeout, implicit 1 secundă) dacă tranzacțiile care așteaptă formează un ciclu. Dacă da, alege o victimă și o anulează cu ERROR: deadlock detected, iar DETAIL arată procesele și lock-urile implicate: Process 1234 waits for ShareLock on transaction 5678; blocked by process 4321.

Exemplul clasic e transferul bancar: o tranzacție mută bani de la contul 1 la 2, alta de la 2 la 1. Prima blochează rândul 1, a doua rândul 2, apoi fiecare cere rândul celeilalte. Același tipar apare la actualizări în loturi în ordini diferite, la chei străine și la rânduri din tabele diferite atinse în ordine inversă.

Deadlock-urile ocazionale sunt normale într-un sistem cu concurență mare; aplicația trebuie să reîncerce tranzacția. Deadlock-urile frecvente indică o ordine de blocare inconsecventă sau tranzacții prea lungi.

De ce apare: cauzele frecvente

1Ordinea lock-urilor depinde de sensul transferului

Greșit
BEGIN;
UPDATE conturi SET sold = sold - 100 WHERE id = :de_la;
UPDATE conturi SET sold = sold + 100 WHERE id = :catre;
COMMIT;
Corect
BEGIN;
SELECT id FROM conturi WHERE id IN (:de_la, :catre)
  ORDER BY id FOR UPDATE;
UPDATE conturi SET sold = sold - 100 WHERE id = :de_la;
UPDATE conturi SET sold = sold + 100 WHERE id = :catre;
COMMIT;

Rândurile sunt blocate întotdeauna în ordinea id-ului, deci două transferuri în sens opus nu mai formează un ciclu.

2Lot de actualizări în ordine aleatoare

Greșit
UPDATE stoc SET cantitate = cantitate - 1 WHERE produs_id IN (7, 3, 9);
Corect
-- sortează id-urile în aplicație și blochează-le în ordine
SELECT produs_id FROM stoc WHERE produs_id IN (3, 7, 9) ORDER BY produs_id FOR UPDATE;

Ordinea în care baza atinge rândurile într-un UPDATE nu e garantată; blocarea explicită în ordine o face determinată.

Repară tu

Repară eroarea, direct în pagină

Răspunde la cele trei întrebări despre deadlock-ul dintre două transferuri bancare în sens opus.

Indiciu

Desenează pe hârtie ce lock ține fiecare tranzacție și ce lock așteaptă.

Alte forme ale mesajului

  • Deadlock found when trying to get lock; try restarting transaction (MySQL 1213)
  • PSQLException: ERROR: deadlock detected Detail: Process 1234 waits for ShareLock on transaction 5678
  • Transaction (Process ID 61) was deadlocked on lock resources with another process and has been chosen as the deadlock victim. (SQL Server)

Cum o eviți pe viitor

  • Blochează rândurile mereu în aceeași ordine (de exemplu după cheia primară).
  • Ține tranzacțiile scurte, fără apeluri externe în ele.
  • Reîncearcă automat tranzacțiile anulate, cu o limită de încercări.
  • Monitorizează numărul de deadlock-uri (pg_stat_database.deadlocks).

Întrebări frecvente

De ce baza nu așteaptă pur și simplu?

Într-un ciclu, nicio tranzacție nu poate termina, deci așteptarea ar fi infinită. Anularea uneia e singura ieșire.

E deadlock același lucru cu un lock care durează mult?

Nu. Un lock lung înseamnă așteptare (care poate expira cu lock_timeout). Deadlock-ul e un ciclu din care nu se poate ieși fără anulare.

Erori înrudite

← Toate erorile System Design

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață System Design de la zero, cu exerciții la fiecare lecție

Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.