Kategoria: Supabase i bazy danych

PostgreSQL: 23505 duplicate key value violates unique constraint

Poradnik techniczny · Kacper Bernecki

Wstawienie lub synchronizacja danych zatrzymuje się na SQLSTATE 23505. Indeks UNIQUE lub PRIMARY KEY wykrył powtórzoną wartość, którą model danych uznaje za unikalną.

Jak ustalić źródło błędu

Przeczytaj nazwę naruszonego constraint i kolumny podane w szczegółach błędu.

Sprawdź, czy to prawdziwy duplikat, ponowienie webhooka czy konflikt numeracji identyfikatorów.

Co zrobić krok po kroku

1. Dla idempotentnych importów zastosuj jawne ON CONFLICT z konkretnym kluczem biznesowym i właściwą semantyką aktualizacji.

2. Jeżeli dane nie powinny być unikalne w tym zakresie, przeprojektuj indeks po sprawdzeniu wymagań zamiast wyłączać wszystkie ograniczenia.

Jak sprawdzić wynik

Ponowne przetworzenie tej samej wiadomości nie tworzy duplikatu i nie niszczy wcześniejszych danych.

Czego nie robić

Nie stosuj ON CONFLICT DO NOTHING dla wszystkich błędów bez ich rejestrowania.