"message": "No message available"
Răspunsul de eroare implicit al Spring Boot nu conține mesajul excepției: de la Boot 2.3, message este ascuns (sau apare ca „No message available” / gol). Activează server.error.include-message=always în dezvoltare sau întoarce mesajul explicit, de exemplu cu ProblemDetail.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spring Boot construiește corpul JSON al erorilor (timestamp, status, error, path) prin DefaultErrorAttributes. Din Spring Boot 2.3, câmpul message este implicit omis sau gol, ca să nu dezvăluie detalii interne. Când e afișat, dar excepția nu are text (de exemplu ResponseStatusException fără motiv sau o excepție creată fără mesaj), valoarea lui devine No message available.
Astfel, clientul vede doar 400 sau 500, fără să afle de ce, deși ai scris un mesaj clar în cod.
Ai două variante. În dezvoltare, server.error.include-message=always (și eventual include-binding-errors=always) pune mesajul în corp. Pentru un API real, e mai bine să controlezi singur formatul: un @RestControllerAdvice care întoarce ProblemDetail (RFC 9457) cu detail completat sau un obiect propriu de eroare.
De ce apare: cauzele frecvente
1Mesajul e ascuns implicit
throw new IllegalArgumentException("Cantitatea trebuie să fie pozitivă");
// răspuns: {"status":400,"error":"Bad Request",...} fără message@ExceptionHandler(IllegalArgumentException.class)
ProblemDetail invalid(IllegalArgumentException e) {
return ProblemDetail.forStatusAndDetail(HttpStatus.BAD_REQUEST, e.getMessage());
}Handler-ul pune explicit mesajul în detail.
2Excepția nu are mesaj
throw new ResponseStatusException(HttpStatus.NOT_FOUND);throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Produsul 42 nu există");Fără motiv, nu ai ce afișa nici cu include-message=always.
Repară eroarea, direct în pagină
POST /cos?cantitate=0 aruncă IllegalArgumentException("Cantitatea trebuie să fie pozitivă"), dar clientul primește doar un 500 fără mesaj. Adaugă un @RestControllerAdvice care tratează IllegalArgumentException și întoarce un ProblemDetail cu statusul 400 și mesajul excepției în detail.
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 CosController {
@PostMapping("/cos")
String adauga(@RequestParam int cantitate) {
if (cantitate <= 0) {
throw new IllegalArgumentException("Cantitatea trebuie să fie pozitivă");
}
return "Adăugat în coș: " + cantitate;
}
}
// TODO: @RestControllerAdvice cu ProblemDetail pentru IllegalArgumentExceptionTomcat started on port 8080 (http)
Started Application
POST /cos?cantitate=0 → 400
{"type":"about:blank","title":"Bad Request","status":400,"detail":"Cantitatea trebuie să fie pozitivă","instance":"/cos"}
POST /cos?cantitate=2 → 200
Adăugat în coș: 2Indiciu
ProblemDetail.forStatusAndDetail(HttpStatus.BAD_REQUEST, 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);
}
}
@RestController
class CosController {
@PostMapping("/cos")
String adauga(@RequestParam int cantitate) {
if (cantitate <= 0) {
throw new IllegalArgumentException("Cantitatea trebuie să fie pozitivă");
}
return "Adăugat în coș: " + cantitate;
}
}
@RestControllerAdvice
class EroriCos {
@ExceptionHandler(IllegalArgumentException.class)
ProblemDetail invalid(IllegalArgumentException e) {
return ProblemDetail.forStatusAndDetail(HttpStatus.BAD_REQUEST, e.getMessage());
}
}De ce merge
Răspunsul implicit al Spring Boot ascunde mesajul excepției, iar o excepție netratată devine 500. Handler-ul din @RestControllerAdvice decide singur formatul: un ProblemDetail cu statusul 400 și mesajul în detail. Clientul primește acum un JSON standard (type, title, status, detail, instance) și știe ce să corecteze. Cererea validă nu e afectată.
Alte forme ale mesajului
"message": ""server.error.include-message=always
Cum o eviți pe viitor
- Hotărăște un format unic pentru erorile API-ului (de exemplu
ProblemDetail) și construiește-l în@RestControllerAdvice. - Dă mesaje tuturor excepțiilor care ajung la client.
- Folosește
include-message=alwaysdoar în dezvoltare; în producție, controlează ce text ajunge la client. - Nu pune în mesaje detalii interne (SQL, căi, stive).
Întrebări frecvente
De ce în tutoriale apare mesajul, iar la mine nu?
Multe tutoriale sunt scrise pentru Spring Boot 2.2 sau mai vechi, când message era inclus implicit.
Ce este ProblemDetail?
Clasa Spring 6 pentru formatul standard RFC 9457: type, title, status, detail, instance. Spring MVC o scrie ca JSON cu Content-Type: application/problem+json.
Erori înrudite
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. 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). Ambiguous @ExceptionHandler method mapped for [class ProdusNegasitException] Două metode @ExceptionHandler din aceeași clasă (controller sau @ControllerAdvice) tratează exact aceeași excepție, iar Spring nu poate alege. Păstrează un singur handler pentru fiecare tip de excepție. Î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.
