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

"message": "No message available"

Pe scurt

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

Greșit
JAVA
throw new IllegalArgumentException("Cantitatea trebuie să fie pozitivă");
// răspuns: {"status":400,"error":"Bad Request",...} fără message
Corect
JAVA
@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

Greșit
JAVA
throw new ResponseStatusException(HttpStatus.NOT_FOUND);
Corect
JAVA
throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Produsul 42 nu există");

Fără motiv, nu ai ce afișa nici cu include-message=always.

Repară tu

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.

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

@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 IllegalArgumentException
După reparație, programul afișează
Tomcat 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ș: 2
Indiciu

ProblemDetail.forStatusAndDetail(HttpStatus.BAD_REQUEST, e.getMessage()).

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=always doar î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

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