Kategoria: Vercel i hosting

Vercel DEPLOYMENT_NOT_FOUND (404) — co sprawdzić po kolei?

Poradnik techniczny · Kacper Bernecki

Błąd 404 DEPLOYMENT_NOT_FOUND wskazuje, że żądanie trafiło pod adres deploymentu, którego Vercel nie znajduje. To co innego niż zwykły błąd 404 konkretnej podstrony aplikacji.

1. Odróżnij brak deploymentu od braku strony

Jeżeli komunikat zawiera DEPLOYMENT_NOT_FOUND, najpierw sprawdź dokładny hostname z paska adresu. Stary link do preview lub nieaktualny adres deploymentu może nie istnieć. Otwórz panel projektu Vercel i porównaj adres z aktualnym, działającym wdrożeniem.

Jeżeli strona główna działa, a 404 dotyczy tylko jednej ścieżki, to prawdopodobnie problem routingu lub konfiguracji aplikacji, a nie nieistniejącego deploymentu.

2. Sprawdź stan wdrożenia i przypisanie domeny

W Vercel otwórz Project → Deployments. Znajdź ostatni deployment produkcyjny i sprawdź, czy ma status Ready. Jeżeli build zakończył się błędem, otwórz Build Logs i napraw pierwszy istotny błąd, nie tylko końcowe build exited with 1.

Następnie przejdź do Settings → Domains. Upewnij się, że Twoja domena jest przypisana do właściwego projektu i że DNS jest zweryfikowany. Jeśli kilka projektów miało podobną nazwę, sprawdź także identyfikator projektu, aby nie diagnozować niepowiązanej aplikacji.

3. Bezpieczne przywrócenie strony

Jeśli wdrożenie produkcyjne nie działa, wybierz znany poprawny deployment i użyj funkcji przywrócenia albo przygotuj nowe wdrożenie z poprawionym kodem. Nie zmieniaj DNS w ciemno. Zmiana adresu domeny bez zrozumienia przyczyny może pogorszyć dostępność.

Na koniec sprawdź stronę pod własną domeną, nie tylko pod adresem .vercel.app, zarówno na komputerze, jak i na telefonie.