...
Eroare Spring Boot · Rute și cereri HTTP: 404, 405, 400

Whitelabel Error Page: This application has no explicit mapping for /error, so you are seeing this as a fallback.

Pe scurt

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

Greșit
JAVA
@GetMapping("/produs")
// browserul cere /produse
Corect
JAVA
@GetMapping("/produse")

Spring compară calea literă cu literă; produs și produse sunt rute diferite.

2Ai deschis rădăcina site-ului fără rută

Greșit
JAVA
http://localhost:8080/
// niciun @GetMapping("/") și niciun index.html
Corect
JAVA
@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)

Greșit
JAVA
There was an unexpected error (type=Internal Server Error, status=500).
Corect
JAVA
// citește stiva din log și repară excepția

Pagina doar semnalează eroarea; cauza e în log.

Repară tu

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.

Codul care dă eroarea
JAVA
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");
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /produse → 200
["Mouse","Tastatură","Monitor"]
Indiciu

Compară calea din @GetMapping cu cea din adresă.

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 @RequestMapping pe clasă, ca să nu le scrii diferit în fiecare metodă.
  • Pentru aplicații cu pagini, adaugă templates/error/404.html sau un handler propriu.
  • Pune server.error.whitelabel.enabled=false doar 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

← Toate erorile Spring Boot

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.