...
Eroare Spring Boot · Excepții și răspunsuri de eroare

There was an unexpected error (type=Internal Server Error, status=500).

Pe scurt

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

Greșit
JAVA
class ComandaNegasitaException extends RuntimeException { ... }
Corect
JAVA
@ResponseStatus(HttpStatus.NOT_FOUND)
class ComandaNegasitaException extends RuntimeException { ... }

@ResponseStatus pe clasa excepției îi spune lui Spring ce cod să trimită.

2Bug neașteptat

Greșit
JAVA
int procent = total / numarProduse;   // numarProduse = 0
Corect
JAVA
if (numarProduse == 0) return 0;

Un 500 dintr-un bug se repară în cod, după ce citești stiva din log.

Repară tu

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.

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);
    }
}

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;
    }
}
După reparație, programul afișează
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.

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 (@ResponseStatus sau 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=always doar î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

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