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.
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ă
if (stoc < cantitate) {
throw new IllegalStateException("Stoc insuficient pentru " + produs);
}
// clientul primește 500@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
String primul = lista.get(0); // lista e goalăif (lista.isEmpty()) {
return ResponseEntity.notFound().build();
}Un bug se repară în cod; handler-ul ar ascunde doar simptomul.
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.
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 IllegalStateExceptionTomcat 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()).
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);
}
}
@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;
}
}
@RestControllerAdvice
class EroriComenzi {
@ExceptionHandler(IllegalStateException.class)
ResponseEntity<String> stocInsuficient(IllegalStateException e) {
return ResponseEntity.status(HttpStatus.CONFLICT).body(e.getMessage());
}
}De ce merge
Excepția din StocService urca prin controller până la DispatcherServlet, nu o trata nimeni, iar Tomcat o logha ca Servlet.service() ... threw exception și răspundea 500. Handler-ul din @RestControllerAdvice o prinde înainte, pentru orice controller, și răspunde 409 Conflict cu mesajul ei. Clientul află acum ce s-a întâmplat, iar comanda validă trece neatinsă.
Alte forme ale mesajului
Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: java.lang.NullPointerException] with root causejakarta.servlet.ServletException: Request processing failed: java.lang.IllegalStateException
Cum o eviți pe viitor
- Ține un
@RestControllerAdvicecare tratează excepțiile de business și întoarce coduri 4xx cu mesaje clare. - Creează excepții proprii (
StocInsuficientException) în loc deIllegalStateExceptiongeneric, 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
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). 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. Cannot invoke "Produs.nume()" because the return value of "java.util.Map.get(Object)" is null Ai apelat o metodă pe rezultatul lui map.get(cheie), dar cheia nu există și get a întors null, deci NullPointerException și 500. Verifică rezultatul înainte (sau folosește getOrDefault / Optional) și răspunde 404 pentru cheile lipsă. Î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.
