Błędny klucz obcy blokuje usunięcie użytkownika w Supabase/ Postgres — diagnostyka i naprawa
Poradnik techniczny · Kacper Bernecki
Typowy symptom: DELETE FROM auth.users WHERE id = '...'; zwraca błąd typu "update or delete on table \"users\" violates foreign key constraint \"...\"" i operacja nie powiodła się. Przyczyną zwykle nie jest błąd Supabase per se, lecz ograniczenia referencyjne w bazie Postgres — brak ON DELETE CASCADE, zalegające rekordy w tabelach powiązanych, anonimowe triggery, lub polityki RLS uniemożliwiające widoczność/usunięcie zależności. Ten dokument prowadzi krok po kroku: jak zlokalizować constraint, upewnić się czy ograniczenie jest spodziewane, ocenić bezpieczne rozwiązania (kaskada, miękkie usuwanie, migracja danych) oraz jak zweryfikować poprawność naprawy bez utraty integralności danych.
Jak rozpoznać przyczynę
Sprawdź komunikat błędu DELETE: Postgres zwraca nazwę constraint i tabelę źródłową. Jeśli komunikat mówi np. "violates foreign key constraint \"fk_orders_user_id\" on table \"orders\"", oznacza to że tabela orders posiada kolumnę user_id referującą do users.id. Nazwa constraint pozwala zlokalizować miejsce problemu bez przeszukiwania całej bazy.
Jeśli komunikat nie występuje (np. usuwanie z poziomu aplikacji), użyj zapytania do katalogów systemowych: join pg_constraint, pg_class i pg_attribute lub information_schema.table_constraints wraz z key_column_usage, aby wypisać wszystkie constraints wskazujące na schemat auth.users. To wyklucza pominięte zależności, w tym te utworzone przez narzędzia migracyjne.
Rozwiązanie krok po kroku
1. 1) Powtórz błąd w SQL Editorze Supabase: uruchom DELETE i skopiuj pełny komunikat błędu. Zapisz nazwę constraint i tabelę docelową. To jedyny pewny dowód które ograniczenie blokuje usunięcie.
2. 2) Zlokalizuj constraint: uruchom zapytanie SELECT z pg_constraint/pg_class, np. SELECT conname, conrelid::regclass AS table_from, confrelid::regclass AS table_to FROM pg_constraint WHERE confrelid = 'auth.users'::regclass OR conrelid = 'auth.users'::regclass; — znajdziesz tabelę zależną i nazwę constraint.
3. 3) Sprawdź powiązane rekordy: dla każdej znalezionej tabeli uruchom SELECT COUNT(*) FROM dependent_table WHERE user_id = '<user_uuid>'; aby ocenić skalę zalegających rekordów i czy są to oczekiwane referencje czy np. artefakty testowe.
4. 4) Sprawdź RLS i uprawnienia: w Supabase sprawdź, czy row level security na zależnych tabelach nie ukrywa rekordów przed robrania poleceń DELETE lub SELECT. Użyj pg_policy i SHOW policies w panelu SQL, pamiętając że brak widoczności może mylić z brakiem referencji.
5. 5) Oceń rozwiązanie: jeśli relacja powinna kasować potomków automatycznie — przygotuj migrację ALTER TABLE dependent_table DROP CONSTRAINT conname; ALTER TABLE dependent_table ADD CONSTRAINT conname FOREIGN KEY (user_id) REFERENCES auth.users(id) ON DELETE CASCADE; — testuj na kopii bazy. Jeśli dane potomne muszą być zachowane, zaplanuj przeniesienie user_id na NULL/anon lub utworzenie rekordu zastępczego.
6. 6) Bezpieczne wykonanie: wykonaj zmiany w transakcji na środowisku staging. Przed zmianą wykonaj pełny backup (pg_dump) i test restore. W przypadku ręcznego usuwania najpierw usuń rekordy z dependent_table w tej samej transakcji lub ustaw user_id = NULL gdzie dopuszczalne.
7. 7) Zaktualizuj migracje: po potwierdzeniu działania w staging dodaj operacje do systemu migracji (np. migration files) i wykonaj deploy wraz z krótkim oknem konserwacyjnym, aby uniknąć wyścigów zapisu/usunięcia.
Jak sprawdzić, czy problem zniknął
Test 1: Ponów DELETE na docelowym użytkowniku; brak błędu i zwrócony stan 1 row affected to dowód sukcesu. Równocześnie uruchom SELECT COUNT(*) FROM dependent_table WHERE user_id = '<user_uuid>' — wynik powinien być 0 lub zgodny z planem (np. NULLy).
Test 2: Sprawdź integralność referencyjną: uruchom SELECT conname, conrelid::regclass, confrelid::regclass FROM pg_constraint WHERE contype='f' i upewnij się, że constraint ma oczekiwaną definicję (ON DELETE CASCADE lub NO ACTION zgodnie z decyzją). Dodatkowo przetestuj podstawowe scenariusze tworzenia rekordu potomnego i usunięcia rodzica.
Czego nie robić
Nie usuwaj constraintu ani nie wykonuj ALTER TABLE bez backupu i testów — można w ten sposób doprowadzić do utraty integralności danych lub pozostawić niepożądane orphaned records.
Nie rozwiązuj problemu wyłącznie poprzez usunięcie użytkownika z audit/logów aplikacji; jeśli zależne rekordy pozostaną, spowoduje to niespójności w raportach i błędy w aplikacji.