Supabase: signed URL pliku przestaje działać — różnicowanie i naprawa
Poradnik techniczny · Kacper Bernecki
Zgłoszenie „signed URL przestaje działać” obejmuje wiele niezwiązanych ze sobą przyczyn: linky presigned wygasają, obiekt został usunięty, zmieniły się reguły RLS/prawa bucketu, albo proxy/CDN buforuje odpowiedź 403 zamiast aktualizować stan. W praktyce klient widzi nagłe 403 lub 404 przy dotychczas działających linkach. To wymaga sekwencyjnej diagnostyki — sprawdzenia parametrów wygasania, integralności obiektu w Storage, roli klucza użytego do generowania linku, konfiguracji bucketu (public/private), ustawień CDN/Cache-Control oraz porównania nagłówków odpowiedzi. Poniższy tekst koncentruje się na konkretnych testach i krokach naprawczych powtarzalnych w realnych środowiskach Supabase bez zakładania dostępu do panów operacyjnych.
Jak rozpoznać przyczynę
Sprawdź najpierw czy odpowiedź to 403 (brak uprawnień) czy 404 (brak obiektu). 404 oznacza usunięcie lub przeniesienie pliku; 403 — problem z autoryzacją, wygasaniem tokenu lub polityką bucketu. Użyj curl -I lub przeglądarkowego Network by odczytać status i nagłówki.
Jeśli status to 403, porównaj sposób generowania signed URL: czy użyto metody createSignedUrl z klienta po stronie serwera czy nieautoryzowanego service_role w kliencie? Sprawdź TTL linku (expiresIn) i czas systemowy serwera (clock skew). CDN/Reverse proxy mogą buforować stare odpowiedzi 403 — sprawdź nagłówki Cache-Control i X-Cache.
Rozwiązanie krok po kroku
1. Zlokalizuj obiekt w panelu Supabase Storage: potwierdź obecność pliku, jego ścieżkę i metadane. Jeśli plik istnieje, zapisz dokładną ścieżkę i rozmiar; jeśli nie, odtwórz go z backupu lub potwierdź, kto i kiedy usunął.
2. Wygeneruj nowy signed URL na serwerze (nie w przeglądarce) używając service_role lub klucza serwera krótkoterminowo i ustaw TTL na krótką wartość (np. 60s). Porównaj wygenerowany URL i parametry expires z tymi, które nie działają.
3. Wykonaj curl -v "<signed_url>" i zanotuj odpowiedź: kod statusu, body, nagłówki Cache-Control, Age, X-Cache i Server-Timing. Brak body + 403 wskazuje na politykę autoryzacji; 404 wskazuje na brak obiektu. Zarejestruj dokładne komunikaty błędów.
4. Sprawdź role i reguły bucketu: jeśli bucket jest prywatny, upewnij się, że używasz podpisanych URL wygenerowanych przez serwer. Jeśli ustawiono nowe polityki RLS/Policies względem storage.objects, tymczasowo przełącz na prostą politykę testową i spróbuj ponownie.
5. Skontroluj zegar serwera/aplikacji (NTP): jeśli podpis używa czasu unixowego, odchyłka >60s może unieważnić URL. Na maszynie generującej link sprawdź date -u i porównaj z time.nist.gov; jeśli różnica, skonfiguruj NTP.
6. Sprawdź konfigurację CDN/Edge: jeśli Supabase lub zewnętrzny CDN buforuje 403, wyczyść cache dla danego URL lub nagłówków, i ponownie wykonaj request z parametrem ?cachebust=timestamp. Potwierdź czy zawartość źródłowa zmieniła się.
7. Przejrzyj logi Supabase (jeśli dostępne) i logi serwera aplikacji: znajdź błędy związane z generowaniem URL, wyjątki przy wywołaniu API storage.createSignedUrl, lub wzmianki o odrzuceniu tokena. Zapisz dokładne komunikaty do analizy.
Jak sprawdzić, czy problem zniknął
Test 1 — natychmiastowy dostęp: po wygenerowaniu nowego signed URL uruchom curl -I i curl --max-time 10 i potwierdź kod 200 oraz poprawny Content-Type i rozmiar. Jeśli 200 — problem był w wygaśnięciu lub cache.
Test 2 — test wygasania: wygeneruj URL z TTL 10s, uzyskaj dostęp natychmiast (oczekiwany 200), odczekaj 15s i ponownie wywołaj — powinien zwrócić 403 lub 404. Ten test potwierdza, że mechanizm TTL działa poprawnie.
Test 3 — porównanie bez CDN: wykonaj bezpośredni request do Supabase z wyczyszczonym cache przeglądarki i z parametrem cachebust, oraz z pominięciem ewentualnego CDN (jeśli możliwe). Brak różnicy oznacza problem po stronie Storage/ACL.
Czego nie robić
Nie używaj klucza service_role w aplikacji frontend: wyciek klucza umożliwia generowanie dowolnych signed URL i modyfikowanie danych. Klucz serverowy zawsze generuje linki po stronie backendu.
Nie wydłużaj TTL signed URL powyżej koniecznego bez rozważenia ryzyka: długi okres zwiększa powierzchnię ataku przy wycieku linku; zamiast tego stosuj krótkie TTL i mechanizm odświeżania.
Nie przypisuj przyczyn na podstawie tytułu zgłoszenia: zrób najpierw status code + nagłówki + obecność pliku. Zakładanie, że „to CDN” bez testu może doprowadzić do niepotrzebnej zmiany konfiguracji.