Kategoria: Supabase i bazy danych

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ą.