Kategoria: Supabase i bazy danych

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.