Supabase upsert nie działa: ON CONFLICT i brak UNIQUE
Poradnik techniczny · Kacper Bernecki
Integracja miała aktualizować istniejący kontakt, ale tworzy duplikat albo zwraca błąd konfliktu.
Dlaczego tak się dzieje?
Upsert potrzebuje jednoznacznego klucza konfliktu zgodnego z ograniczeniem PRIMARY KEY lub UNIQUE. Samo pole e-mail bez właściwego indeksu nie gwarantuje poprawnego zachowania.
Rozwiązanie krok po kroku
1. Ustal stabilny identyfikator zdarzenia lub zewnętrznego rekordu, a nie wyłącznie nazwisko lub telefon.
2. Dodaj odpowiedni unikalny indeks w bazie, po uprzednim bezpiecznym uporządkowaniu istniejących duplikatów.
3. W zapytaniu upsert wskaż onConflict zgodny z indeksem.
4. Sprawdź jednoczesne dostarczenie dwóch identycznych webhooków i zachowanie przy błędzie sieci.
5. Oddziel deduplikację zdarzeń od łączenia kilku autentycznych zgłoszeń tej samej osoby.
Jak sprawdzić wynik?
Dwukrotne przetworzenie tego samego zdarzenia nie tworzy podwójnego wpisu ani kolejnego powiadomienia.
Unikalność po samym numerze telefonu może skleić różne osoby lub dwa odrębne zgłoszenia. Projektuj klucz zgodnie z definicją zdarzenia.