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

Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: java.lang.IllegalStateException: Stoc insuficient pentru Mouse] with root cause

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Rândul de log ERROR ... Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [...] with root cause apare când o excepție iese din DispatcherServlet fără să fie tratată. Tomcat o înregistrează, iar Spring Boot trimite clientului răspunsul de eroare implicit: 500 Internal Server Error.

Citește-l așa: [dispatcherServlet] este servletul Spring MVC, path [] contextul aplicației (gol = rădăcina), iar între parantezele drepte este excepția: Request processing failed: java.lang.IllegalStateException: Stoc insuficient pentru Mouse. Sub rând urmează stiva de apeluri; caută primul rând care conține un pachet al tău, acolo s-a aruncat excepția.

Uneori excepția e un bug (NullPointerException, IndexOutOfBoundsException): o repari. Alteori e o situație de business (stoc insuficient, comandă inexistentă), care ar trebui să devină un răspuns 4xx clar, prin @ExceptionHandler, @ResponseStatus sau ResponseStatusException.

De ce apare: cauzele frecvente

1Excepție de business netratată

Greșit
JAVA
if (stoc < cantitate) {
    throw new IllegalStateException("Stoc insuficient pentru " + produs);
}
// clientul primește 500
Corect
JAVA
@RestControllerAdvice
class Erori {
    @ExceptionHandler(IllegalStateException.class)
    ResponseEntity<String> stoc(IllegalStateException e) {
        return ResponseEntity.status(HttpStatus.CONFLICT).body(e.getMessage());
    }
}

Handler-ul transformă excepția într-un răspuns 409 cu mesaj, în loc de 500.

2Bug în cod

Greșit
JAVA
String primul = lista.get(0);   // lista e goală
Corect
JAVA
if (lista.isEmpty()) {
    return ResponseEntity.notFound().build();
}

Un bug se repară în cod; handler-ul ar ascunde doar simptomul.

Repară tu

Repară eroarea, direct în pagină

POST /comenzi?produs=Mouse&cantitate=5 răspunde 500, iar în log apare Servlet.service() ... threw exception [Request processing failed: java.lang.IllegalStateException: Stoc insuficient pentru Mouse]. Adaugă un @RestControllerAdvice care tratează IllegalStateException și răspunde 409 cu mesajul excepției.

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

@Service
class StocService {
    private final Map<String, Integer> stoc = Map.of("Mouse", 3);

    void rezerva(String produs, int cantitate) {
        if (stoc.getOrDefault(produs, 0) < cantitate) {
            throw new IllegalStateException("Stoc insuficient pentru " + produs);
        }
    }
}

@RestController
class ComandaController {
    private final StocService stoc;

    ComandaController(StocService stoc) {
        this.stoc = stoc;
    }

    @PostMapping("/comenzi")
    String plaseaza(@RequestParam String produs, @RequestParam int cantitate) {
        stoc.rezerva(produs, cantitate);
        return "Comandă plasată: " + cantitate + " x " + produs;
    }
}

// TODO: un @RestControllerAdvice pentru IllegalStateException
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
POST /comenzi?produs=Mouse&cantitate=5 → 409
Stoc insuficient pentru Mouse
POST /comenzi?produs=Mouse&cantitate=2 → 200
Comandă plasată: 2 x Mouse
Indiciu

ResponseEntity.status(HttpStatus.CONFLICT).body(e.getMessage()).

Alte forme ale mesajului

  • Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: java.lang.NullPointerException] with root cause
  • jakarta.servlet.ServletException: Request processing failed: java.lang.IllegalStateException

Cum o eviți pe viitor

  • Ține un @RestControllerAdvice care tratează excepțiile de business și întoarce coduri 4xx cu mesaje clare.
  • Creează excepții proprii (StocInsuficientException) în loc de IllegalStateException generic, ca handler-ul să fie precis.
  • Lasă excepțiile neașteptate să ajungă la 500, dar loghează-le și monitorizează-le.
  • Testează cu MockMvc și cazurile de eroare.

Întrebări frecvente

De ce clientul vede doar Internal Server Error?

Spring Boot ascunde implicit mesajul excepției, ca să nu dezvăluie detalii interne. Mesajul e în log; pentru client, tratează excepția explicit.

Ce înseamnă with root cause?

Că sub rând urmează stiva cauzei originale, chiar dacă a fost împachetată în alte excepții.

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.