Supabase: PGRST116 przy .single(), gdy nie ma żadnego wiersza
Poradnik techniczny · Kacper Bernecki
Wywołanie .single() zwraca PGRST116 i komunikat o braku pojedynczego obiektu. Metoda .single() oczekuje dokładnie jednego rekordu, ale query mogło zwrócić zero lub więcej niż jeden.
Jak ustalić źródło błędu
Sprawdź filtr kolumn i wynik tego samego zapytania bez .single().
Porównaj założenie unikalności rekordu z faktycznymi danymi oraz politykami RLS.
Co zrobić krok po kroku
1. Jeżeli zero rekordów jest dopuszczalne biznesowo, zastosuj .maybeSingle() z osobną obsługą null.
2. Jeżeli rekord musi istnieć dokładnie jeden, napraw dane lub dodaj odpowiednie ograniczenie unikalności w bazie.
Jak sprawdzić wynik
Pusty wynik nie generuje nieobsłużonego wyjątku, a dwa rekordy dla unikalnego identyfikatora są wykrywane.
Czego nie robić
Nie wyciszaj każdego PGRST116 jako null, jeżeli brak rekordu oznacza utratę danych.