Kategoria: Supabase i bazy danych

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.