Supabase: SELECT zwraca puste wyniki pomimo poprawnej autoryzacji — diagnostyka RLS
Poradnik techniczny · Kacper Bernecki
Problem: użytkownik widzi aktywną sesję w kliencie Supabase, token jest obecny, ale SELECT na tabeli zwraca puste wyniki lub 0 wierszy. Przyczyny są zwykle w konfiguracji RLS (brak policy, błędna expression, USING/ WITH CHECK, role anon/auth) lub w warstwie uwierzytelniania (token nie zawiera oczekiwanych claimów, niewłaściwe audience/issuer, lub request wykonywany jako service_role). Ten dokument prowadzi przez kontrolowane testy: potwierdzenie roli, inspekcja policy, symulowanie zapytania przez SQL editor, sprawdzenie claimów JWT i wskazuje konkretne poprawki oraz minimalny test weryfikacyjny przed wdrożeniem zmian.
Jak rozpoznać przyczynę
Sprawdź czy tabela ma włączone RLS: w Dashboard → Table Editor → zakładka Policies jest aktywna. Jeżeli RLS jest włączone i brak jest policy dla akcji SELECT, wszystkie zwykłe role (auth/anon) dostaną 0 wyników. Częsta pomyłka: wyłączenie RLS zamiast dodania właściwych reguł.
Zweryfikuj treść policy: policy SELECT może mieć clause USING lub expression sprawdzające np. auth.uid() = owner_id. Błąd w nazwie kolumny, typie lub operatorze (np. = zamiast IS NOT DISTINCT FROM) skutkuje odrzuceniem wiersza. Różnica między USING (filtr) a WITH CHECK (dla INSERT/UPDATE) jest krytyczna.
Sprawdź kontekst zapytania: token klienta musi być przekazany i zawierać poprawny sub (auth.uid()) lub custom claim używany w policy. Jeśli zapytanie wykonujesz z serwera przy użyciu service_role, RLS jest wyłączone i wyniki będą inne niż z klienta. Upewnij się, że request pochodzi z tego samego tokena, który obserwujesz.
Rozwiązanie krok po kroku
1. Potwierdź autoryzację: w konsoli przeglądarki sprawdź localStorage/sessionStorage klucza "supabase.auth.token" lub wywołaj supabase.auth.getSession() i zapisz zwrócony access_token; nie zakładaj, że obecność UI = ważny token.
2. Otwórz SQL Editor w Supabase i wykonaj SELECT z użyciem funkcji auth.uid(): SELECT auth.uid(), current_setting('request.jwt.claims', true); — sprawdź czy auth.uid() zwraca oczekiwane id. Jeśli NULL, token nie jest poprawnie przesyłany.
3. Sprawdź polityki: przejdź do Table Editor → Policies; dla SELECT sprawdź USING expression. Dla testu tymczasowo dodaj prostą policy allow dla swojej roli: USING (true) — to pozwoli ustalić, czy problem wynika z reguł.
4. Przetestuj zapytanie klienta vs SQL Editor: porównaj wyniki gdy wykonujesz ten sam SELECT w SQL Editor (wykonane w kontekście dashboarda) i z aplikacji przeglądarkowej (używając access_token). Różnice wskażą problem z tokenem lub z headerami.
5. Zbadaj JWT: zdekoduj access_token (base64) i porównaj claim 'sub' lub custom claim wymagany w policy. Upewnij się, że issuer/audience odpowiada konfiguracji projektu. Jeśli claim nie istnieje, policy nie przepuści wierszy.
6. Sprawdź role używane w policy: wiele przykładów używa role() = 'authenticated' lub current_setting('request.jwt.claims.role', true). Jeśli policy odnosi się do niestandardowego pola role, potwierdź że jest ono obecne w JWT.
7. Przywróć bezpieczną politykę: po diagnostyce zastąp tymczasowy USING(true) precyzyjną regułą np. USING (auth.uid() = owner_id) i wykonaj testy z tokenem zawierającym sub odpowiadającym owner_id.
Jak sprawdzić, czy problem zniknął
Test A: Zaloguj się w aplikacji jako użytkownik testowy, wykonaj zapytanie SELECT z klienta. Oczekiwany wynik: zwrócone wiersze posiadające owner_id równy auth.uid().
Test B: W SQL Editor wykonaj to samo SELECT symulując dashboard (bez RLS zmiany) i porównaj; jeśli SQL Editor zwraca wiersze, a klient nie — problem z tokenem lub nagłówkami.
Test C: Po przywróceniu właściwej policy usuń tymczasowy USING(true) i powtórz Test A; jeśli niepowodzenie, sprawdź logi serwera i dekoduj token w momencie żądania.
Czego nie robić
Nie zostawiaj trwałego USING(true) w produkcji — otwiera dostęp do wszystkich wierszy.
Nie diagnozuj po Dashboard SQL Editor; wyniki tam mogą różnić się od klienta z powodu innego kontekstu RLS.
Nie edytuj policy bez backupu; skopiuj istniejącą definicję przed modyfikacją.