Supabase Storage 413 EntityTooLarge przy uploadzie zdjęć lub wideo
Poradnik techniczny · Kacper Bernecki
HTTP 413 EntityTooLarge oznacza przekroczenie limitu rozmiaru w trakcie przesyłania. To nie jest typowy błąd uprawnień RLS. Naprawę zacznij od porównania rzeczywistego rozmiaru pliku z limitami projektu i konkretnego zasobnika.
Jak rozpoznać przyczynę
Sprawdź pełny kod odpowiedzi i komunikat Storage, nie tylko ogólne 'upload failed'. Zapisz rozmiar pliku w bajtach, nazwę bucketa oraz metodę uploadu. Plik z telefonu może być znacznie większy niż miniatura wyświetlana w interfejsie.
Supabase pozwala ustawić limit globalny i niższy limit dla poszczególnych bucketów. Faktyczny dopuszczalny rozmiar wynika z obu tych konfiguracji, a dostępność wyższych wartości zależy od planu projektu.
Rozwiązanie krok po kroku
1. Otwórz Supabase → Storage Settings i sprawdź Global file size limit. Nie zmieniaj go bez oszacowania kosztów i zapotrzebowania aplikacji.
2. Przejdź do ustawień docelowego bucketa i zweryfikuj jego własne ograniczenia rozmiaru oraz dozwolone typy MIME.
3. Jeżeli plik jest większy od uzasadnionego limitu, w aplikacji pokaż zrozumiały komunikat przed wysłaniem. W razie potrzeby zastosuj kompresję albo osobną ścieżkę dla dużych materiałów.
4. Dla większych plików oceń mechanizm resumable upload oparty na TUS, zamiast wielokrotnie ponawiać jeden duży upload standardowy przez niestabilne łącze.
5. Jeśli plik mieści się w limitach, sprawdź pośredniczący serwer Next.js lub proxy, które również może narzucać własny limit żądania.
Jak sprawdzić, czy problem zniknął
Przetestuj jeden plik mniejszy od limitu i jeden większy. Mały powinien zostać zapisany i odczytany, a duży otrzymać kontrolowany komunikat bez niekończącej się animacji.
Sprawdź, czy zapisany obiekt ma poprawny rozmiar i metadane oraz czy nie powstały osierocone pliki po błędnym lub przerwanym uploadzie.
Czego nie robić
Nie wyłączaj RLS w celu naprawy odpowiedzi 413. Nie zwiększaj też globalnego limitu do maksimum wyłącznie dla jednego formularza z małymi załącznikami.