Kategoria: Vercel i hosting

Next.js na Vercel: Error 500 dopiero po wdrożeniu

Poradnik techniczny · Kacper Bernecki

Strona działa lokalnie, lecz produkcyjna podstrona lub API zwraca 500 Internal Server Error.

Skąd bierze się problem?

Środowisko produkcyjne ma inne zmienne, ograniczenia runtime lub uprawnienia dostępu do usług. Kompilacja bez błędów nie potwierdza działania endpointów.

Co zrobić krok po kroku?

1. Otwórz Runtime Logs dokładnego wdrożenia w panelu Vercel i znajdź żądanie, które zwróciło 500.

2. Sprawdź wymagane ENV i sposób ich odczytu po stronie serwera.

3. Zweryfikuj połączenia z bazą, zewnętrznym API i dostępność zależności.

4. Ustal, czy błąd zależy od jednej ścieżki, metody HTTP czy danych wejściowych.

5. Dodaj obsługę błędów bez ujawniania sekretów i wykonaj test na środowisku produkcyjnym.

Test poprawki i ważna pułapka

Ten sam scenariusz działa na produkcji, logi nie zawierają sekretów, a niepoprawne dane zwracają kontrolowany kod błędu.

Nie pokazuj użytkownikom surowych stack trace ani kluczy API w odpowiedziach serwera.