Kategoria: Supabase i bazy danych

Supabase — brak widocznych rekordów po zmianie roli użytkownika (diagnostyka różnicowa)

Poradnik techniczny · Kacper Bernecki

Typowy objaw: po modyfikacji roli użytkownika (np. z anon na authenticated lub na custom role) aplikacja przestaje widzieć rekordy w tabeli. Przyczyny zwykle leżą po stronie Postgresowego modelu uprawnień i Row Level Security (RLS) w Supabase: zmiana roli wpływa na to, jakie polityki są oceniane i które GRANTy obowiązują. Innymi czynnikami są: niezgodne claims w JWT (role claim z inną nazwą), brak mapowania roli na użytkownika w Supabase Auth, lub pomyłka w ustawieniu uprawnień schematu/public. Poniższy tekst prowadzi krok po kroku diagnostykę różnicową, precyzyjne testy i kroki naprawcze bez zakładania przyczyny w tytule backlogu.

Jak rozpoznać przyczynę

Sprawdź, która rola jest widoczna dla bieżącego połączenia: wykonaj SELECT current_user, session_user; oraz SELECT current_setting('jwt.claims.role', true); w sesji po stronie serwera (np. SQL editor Supabase). Jeśli current_user różni się od oczekiwanej roli, zapytania mogą być filtrowane przez inne polityki RLS.

Zweryfikuj polityki RLS na danej tabeli: SELECT policyname, permissive, roles FROM pg_policies WHERE schemaname='public' AND tablename='twoja_tabela';. Polityki mogą odnosić się do konkretnej roli (roles = '{authenticated}') i po zmianie roli użytkownika nie będą stosowane, co skutkuje zwracaniem 0 rekordów.

Rozwiązanie krok po kroku

1. Zaloguj się do SQL editor w panelu Supabase i uruchom: SELECT current_user, session_user; zapis wyników. To pokaże nazwę roli Postgres, którą widzi sesja po zmianie roli użytkownika.

2. Sprawdź wartość claim role w JWT, jeśli używasz JWT: SELECT current_setting('jwt.claims.role', true); lub wyciągnij token z klienta i rozkoduj payload. Brakujący lub inny claim 'role' oznacza błędne mapowanie uprawnień.

3. Wypisz polityki RLS dla tabeli: SELECT policyname, roles, qual, with_check FROM pg_policies WHERE tablename='twoja_tabela';. Zwróć uwagę na kolumnę roles — jeśli zawiera np. {authenticated} a użytkownik ma inną rolę, polityka nie umożliwi dostępu.

4. Zweryfikuj GRANTy na schemacie i tabeli: SELECT grantee, privilege_type FROM information_schema.role_table_grants WHERE table_name='twoja_tabela';. Brak SELECT dla roli uniemożliwi odczyt niezależnie od RLS.

5. Jeśli używasz custom role w Auth, sprawdź mapping w ustawieniach projektu Supabase (Auth -> Settings -> External JWT / Provider). Upewnij się, że token zawiera claim 'role' zgodny z nazwą roli w Postgres.

6. Tymczasowo przełącz użytkownika na znaną działającą rolę (np. anon lub authenticated) przez wystawienie tokena testowego i zweryfikuj, czy rekordy wracają. To odróżni problem RLS/GRANT od problemu z danymi.

7. Jeśli potwierdzisz, że polityki blokują dostęp, stwórz lub zmodyfikuj politykę: CREATE POLICY ... USING (auth.role() = 'twoja_rola' OR <warunek>); lub dodaj odpowiedni GRANT SELECT ON table TO role; i przetestuj ponownie.

Jak sprawdzić, czy problem zniknął

Po modyfikacji polityk uruchom zapytanie z tej samej sesji/testowego tokena: SELECT count(*) FROM public.twoja_tabela; oraz SELECT * LIMIT 5; — jeżeli count>0 i SELECT zwraca wiersze, naprawa działa.

Wykonaj test regresji: autoryzuj klienta z inną rolą (np. anon) i powtórz te same zapytania. Wyniki powinny odzwierciedlać zamierzone ograniczenia polityk (różne role różne widoki).

Czego nie robić

Nie modyfikuj polityk RLS bez testu na kopii tabeli — złe wyrażenie qual może przypadkowo umożliwić dostęp do wszystkich wierszy.

Nie zakładaj, że claim w JWT nazywa się 'role' — niektóre zewnętrzne provider'y używają innych nazw. Rozkoduj token i sprawdź dokładną nazwę claim.

Unikaj przyznawania szerokich GRANT public do czasu potwierdzenia, że problem to rzeczywiście brak uprawnień; to tymczasowe rozwiązanie zwiększa ryzyko nieautoryzowanego dostępu.