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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Rândul apare în pagina implicită de eroare a Spring Boot (Whitelabel), afișată în browser. type=Internal Server Error e textul standard al codului, iar status=500 codul HTTP. Înseamnă că o excepție a ieșit din controller netratată.
Pagina nu conține excepția (Spring Boot o ascunde implicit, din motive de securitate). O găsești în consolă sau în fișierul de log: Servlet.service() for servlet [dispatcherServlet] ... threw exception, cu stiva de apeluri.
O cauză foarte frecventă la API-urile noi: arunci o excepție proprie pentru o situație normală (produs inexistent, comandă deja anulată), dar Spring nu știe ce cod să-i dea și folosește 500. Excepțiile proprii pot primi direct codul, cu @ResponseStatus(HttpStatus.NOT_FOUND) pe clasa lor.
De ce apare: cauzele frecvente
1Excepție proprie fără cod HTTP
class ComandaNegasitaException extends RuntimeException { ... }@ResponseStatus(HttpStatus.NOT_FOUND)
class ComandaNegasitaException extends RuntimeException { ... }@ResponseStatus pe clasa excepției îi spune lui Spring ce cod să trimită.
2Bug neașteptat
int procent = total / numarProduse; // numarProduse = 0if (numarProduse == 0) return 0;Un 500 dintr-un bug se repară în cod, după ce citești stiva din log.
Repară eroarea, direct în pagină
GET /comenzi/99 pentru o comandă inexistentă afișează There was an unexpected error (type=Internal Server Error, status=500). Codul aruncă deja ComandaNegasitaException. Fă ca această excepție să producă 404 Not Found, punând adnotarea potrivită pe clasa ei.
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);
}
}
class ComandaNegasitaException extends RuntimeException {
ComandaNegasitaException(long id) {
super("Comanda " + id + " nu există");
}
}
@RestController
class ComandaController {
private final Map<Long, String> comenzi = Map.of(1L, "2 x Mouse");
@GetMapping("/comenzi/{id}")
String comanda(@PathVariable long id) {
String c = comenzi.get(id);
if (c == null) {
throw new ComandaNegasitaException(id);
}
return c;
}
}Tomcat started on port 8080 (http)
Started Application
GET /comenzi/1 → 200
2 x Mouse
GET /comenzi/99 → 404
{"status":404,"error":"Not Found","message":"Comanda 99 nu există","path":"/comenzi/99"}Indiciu
@ResponseStatus(HttpStatus.NOT_FOUND) se pune pe clasa excepției.
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);
}
}
@ResponseStatus(HttpStatus.NOT_FOUND)
class ComandaNegasitaException extends RuntimeException {
ComandaNegasitaException(long id) {
super("Comanda " + id + " nu există");
}
}
@RestController
class ComandaController {
private final Map<Long, String> comenzi = Map.of(1L, "2 x Mouse");
@GetMapping("/comenzi/{id}")
String comanda(@PathVariable long id) {
String c = comenzi.get(id);
if (c == null) {
throw new ComandaNegasitaException(id);
}
return c;
}
}De ce merge
Spring nu știa ce înseamnă ComandaNegasitaException, așa că a tratat-o ca pe orice eroare neașteptată: 500. @ResponseStatus(HttpStatus.NOT_FOUND) pe clasa excepției îi spune codul potrivit, iar acum o comandă inexistentă dă 404, cu mesajul excepției (vizibil aici pentru că server.error.include-message=always). Comanda existentă răspunde ca înainte.
Alte forme ale mesajului
There was an unexpected error (type=Not Found, status=404).There was an unexpected error (type=Bad Request, status=400).
Cum o eviți pe viitor
- Dă fiecărei excepții proprii un cod HTTP (
@ResponseStatussau handler). - Folosește 404 pentru resurse lipsă, 409 pentru conflicte de stare, 400 pentru date invalide.
- Păstrează 500 pentru ce e cu adevărat neașteptat și urmărește-l în log.
- Pune
server.error.include-message=alwaysdoar în dezvoltare, dacă vrei mesajul în răspuns.
Întrebări frecvente
Cum văd excepția din spatele paginii?
În consola aplicației sau în log, la rândul cu Servlet.service() ... threw exception, urmat de stiva de apeluri.
@ResponseStatus sau @ExceptionHandler?
@ResponseStatus e cel mai simplu pentru un cod fix. @ExceptionHandler îți permite să construiești corpul răspunsului (JSON, ProblemDetail).
Erori înrudite
Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: java.lang.IllegalStateException: Stoc insuficient pentru Mouse] with root cause O excepție aruncată din controller sau serviciu nu a fost tratată nicăieri, a ajuns până la servlet, iar clientul a primit 500. Excepția reală e în paranteze și în stiva de sub mesaj. Repar-o sau trateaz-o cu un @ExceptionHandler care întoarce statusul potrivit. 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. org.springframework.web.server.ResponseStatusException: 404 NOT_FOUND "Produsul 42 nu există" Este excepția prin care codul tău cere explicit un răspuns cu un anumit status (aici 404) și un motiv. Nu e un bug: Spring o transformă în răspunsul HTTP. Dacă apare unde nu te aștepți, verifică de ce lipsește resursa. Î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.
