Whitelabel Error Page: This application has no explicit mapping for /error, so you are seeing this as a fallback.
Este pagina de eroare implicită a Spring Boot, afișată în browser când cererea se termină cu o eroare (de obicei 404: nicio rută pentru adresa cerută, sau 500). Citește type și status de sub ea, apoi verifică ruta, metoda HTTP și logul aplicației.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când o cerere se termină cu eroare, Spring Boot o trimite intern la ruta /error. Dacă aplicația nu are o pagină proprie pentru /error, browserul primește pagina „Whitelabel”:
Whitelabel Error Page
This application has no explicit mapping for /error, so you are seeing this as a fallback.
There was an unexpected error (type=Not Found, status=404).Prima frază nu e problema reală: spune doar că nu ai personalizat pagina de eroare. Informația importantă e rândul type=..., status=.... Cu 404, nicio metodă nu răspunde la adresa cerută (cale scrisă greșit, prefix lipsă, controller nescanat). Cu 405, metoda HTTP nu se potrivește. Cu 500, codul a aruncat o excepție: detaliile sunt în log.
Un client REST (Postman, curl, front-end) nu vede pagina HTML, ci JSON-ul echivalent: {"status":404,"error":"Not Found","path":"/produse"}.
De ce apare: cauzele frecvente
1Calea din adresă nu corespunde rutei
@GetMapping("/produs")
// browserul cere /produse@GetMapping("/produse")Spring compară calea literă cu literă; produs și produse sunt rute diferite.
2Ai deschis rădăcina site-ului fără rută
http://localhost:8080/
// niciun @GetMapping("/") și niciun index.html@GetMapping("/")
String acasa() { return "Magazin online"; }Un API nou nu are nimic la /; e normal să vezi Whitelabel acolo.
3Excepție în cod (status=500)
There was an unexpected error (type=Internal Server Error, status=500).// citește stiva din log și repară excepțiaPagina doar semnalează eroarea; cauza e în log.
Repară eroarea, direct în pagină
În browser, http://localhost:8080/produse afișează Whitelabel Error Page cu status=404. Controller-ul există, dar ruta e scrisă altfel. Repar-o ca GET /produse să răspundă cu lista de produse.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ProdusController {
@GetMapping("/produs")
List<String> produse() {
return List.of("Mouse", "Tastatură", "Monitor");
}
}Tomcat started on port 8080 (http) Started Application GET /produse → 200 ["Mouse","Tastatură","Monitor"]
Indiciu
Compară calea din @GetMapping cu cea din adresă.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ProdusController {
@GetMapping("/produse")
List<String> produse() {
return List.of("Mouse", "Tastatură", "Monitor");
}
}De ce merge
Pagina Whitelabel apărea pentru că nicio metodă nu era mapată pe /produse: ruta era /produs. Spring nu face potriviri aproximative, așa că a răspuns 404 și a afișat pagina de eroare implicită. Cu calea corectă, cererea ajunge la metodă și primești lista în JSON. Când vezi Whitelabel, citește întâi status: 404 te trimite la rute, 500 la log.
Alte forme ale mesajului
There was an unexpected error (type=Not Found, status=404).There was an unexpected error (type=Internal Server Error, status=500).
Cum o eviți pe viitor
- Testează rutele din Postman sau
curl, unde vezi direct statusul și JSON-ul. - Ține prefixele comune într-un
@RequestMappingpe clasă, ca să nu le scrii diferit în fiecare metodă. - Pentru aplicații cu pagini, adaugă
templates/error/404.htmlsau un handler propriu. - Pune
server.error.whitelabel.enabled=falsedoar dacă ai propria pagină de eroare.
Întrebări frecvente
Cum scap de pagina Whitelabel?
Repară cauza (ruta sau excepția). Ca să o înlocuiești, adaugă error.html (sau error/404.html) în templates ori un @ControllerAdvice.
De ce apare chiar la http://localhost:8080?
Pentru că API-ul tău nu are nimic la /. Deschide o rută existentă, de exemplu /api/produse.
Erori înrudite
No static resource api/produse. În Spring Boot 3.2+, o cerere pentru care nu există niciun controller ajunge la handler-ul de fișiere statice, care nu găsește nimic și răspunde 404 cu NoResourceFoundException. Verifică calea, prefixul @RequestMapping de pe clasă și adnotarea @RestController. Request method 'POST' is not supported Calea există, dar nu acceptă metoda HTTP folosită (de exemplu ai doar @GetMapping, iar clientul trimite POST), deci răspunsul este 405 Method Not Allowed. Adaugă metoda potrivită (@PostMapping) sau trimite cererea cu metoda corectă. There was an unexpected error (type=Internal Server Error, status=500). Rândul din pagina Whitelabel spune că o excepție netratată a produs 500. Cauza e în log. Pentru excepțiile tale de business, adaugă @ResponseStatus pe clasa excepției sau un @ExceptionHandler, ca să răspunzi cu codul potrivit (404, 409). Învață Spring Boot de la zero, cu exerciții la fiecare lecție
Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.
