PostgreSQL: 40P01 deadlock detected podczas równoczesnego zapisu
Poradnik techniczny · Kacper Bernecki
Podczas równoległego zapisywania dwóch rekordów jedna transakcja kończy się błędem deadlock detected, choć pojedyncze zapisy działają. Dwie transakcje czekają na blokady trzymane przez siebie nawzajem; PostgreSQL przerywa jedną, by rozwiązać cykl zależności.
Jak ustalić źródło błędu
Sprawdź szczegóły deadlock w logach Postgres: PID transakcji, relacje i statementy oczekujące na blokadę.
Porównaj kolejność UPDATE dwóch tabel w konkurujących operacjach i sprawdź długość transakcji, szczególnie przy callbackach CRM.
Co zrobić krok po kroku
1. Ustal spójny porządek pobierania blokad i modyfikowania tabel dla wszystkich kodowych ścieżek tego samego procesu.
2. Skróć transakcje, a SQLSTATE 40P01 obsłuż ograniczonym retry całej transakcji z idempotentnym zapisem skutków ubocznych.
Jak sprawdzić wynik
Równoległe testy obciążeniowe kończą się poprawnymi wynikami bez utraty aktualizacji oraz bez podwójnych webhooków i powtórnych płatności.
Czego nie robić
Nie zwiększaj wyłącznie lock_timeout jako rozwiązania, ponieważ nie usuwa to cyklicznej zależności blokad między transakcjami.