Kategoria: Next.js, React i TypeScript

Next.js Server Action odrzuca większy formularz lub załącznik

Poradnik techniczny · Kacper Bernecki

Mały formularz działa, a przesłanie większej liczby pól lub pliku kończy się błędem limitu rozmiaru żądania. Server Actions mają ustawienia ograniczające rozmiar przesyłanych danych i nie są automatycznie najlepszą drogą do dużych plików.

Jak ustalić źródło błędu

Sprawdź rozmiar faktycznego body w Network i treść błędu na serwerze.

Ustal, czy w payloadzie jest plik, base64 lub powtarzany duży JSON zamiast samych pól.

Co zrobić krok po kroku

1. Przenieś duży upload do odpowiednio zabezpieczonego storage lub osobnego endpointu; w Server Action przekazuj identyfikator pliku.

2. Jeśli to uzasadniony mały wzrost danych, skonfiguruj odpowiedni limit po ocenie ryzyka i dodaj walidację rozmiaru.

Jak sprawdzić wynik

Formularz z prawidłowym rozmiarem przechodzi, a przekroczenie limitu daje czytelny komunikat zamiast błędu 500.

Czego nie robić

Nie podnoś globalnie limitu do dowolnej wartości, bo zwiększa to koszt i powierzchnię ataku.