Required request body is missing
Metoda are un parametru @RequestBody, dar cererea a venit fără corp (adesea datele erau în query sau cererea era GET), deci Spring răspunde 400. Trimite JSON-ul în corpul cererii sau citește datele cu @RequestParam dacă vin în adresă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
@RequestBody îi spune lui Spring să citească tot corpul cererii și să-l transforme (de obicei din JSON) în obiectul parametrului. Dacă cererea nu are corp, Spring aruncă HttpMessageNotReadableException: Required request body is missing: public ... Controller.metoda(...) și răspunde 400.
În log apare WARN ... Resolved [org.springframework.http.converter.HttpMessageNotReadableException: Required request body is missing: ...], cu semnătura metodei, deci știi exact unde.
Cazurile tipice: clientul pune datele în adresă (?email=...) în timp ce controller-ul așteaptă JSON; o cerere GET (care în mod normal nu are corp) are @RequestBody; în Postman ai uitat să alegi Body > raw > JSON; sau un front-end trimite fetch fără body. Dacă corpul e opțional, folosește @RequestBody(required = false).
De ce apare: cauzele frecvente
1Datele vin în adresă, nu în corp
POST /abonare?email=ana@exemplu.ro
@PostMapping("/abonare")
String abonare(@RequestBody String email) { ... }@PostMapping("/abonare")
String abonare(@RequestParam String email) { ... }Parametrii din query se citesc cu @RequestParam; @RequestBody citește doar corpul.
2Cererea nu are corp deloc
fetch('/api/comenzi', { method: 'POST' })fetch('/api/comenzi', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ produs: 'Mouse' })
})Corpul trebuie trimis explicit, cu antetul Content-Type potrivit.
Repară eroarea, direct în pagină
Formularul de abonare trimite POST /abonare?email=ana@exemplu.ro, iar răspunsul este 400: Required request body is missing. Emailul vine în adresă, nu în corp. Schimbă parametrul metodei ca ruta să răspundă Abonat: ana@exemplu.ro.
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 AbonareController {
@PostMapping("/abonare")
String abonare(@RequestBody String email) {
return "Abonat: " + email;
}
}Tomcat started on port 8080 (http) Started Application POST /abonare?email=ana@exemplu.ro → 200 Abonat: ana@exemplu.ro
Indiciu
Datele din query se citesc cu altă adnotare decât @RequestBody.
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 AbonareController {
@PostMapping("/abonare")
String abonare(@RequestParam String email) {
return "Abonat: " + email;
}
}De ce merge
@RequestBody caută datele în corpul cererii, care era gol, așa că Spring a răspuns 400 înainte să intre în metodă. Emailul era în adresă (?email=...), iar parametrii de acolo se citesc cu @RequestParam. Regula simplă: identificatorul resursei vine în cale (@PathVariable), filtrele și opțiunile în query (@RequestParam), obiectele trimise în corp (@RequestBody).
Alte forme ale mesajului
Required request body is missing: public java.lang.String AbonareController.abonare(java.lang.String)
Cum o eviți pe viitor
- Hotărăște pentru fiecare rută de unde vin datele: din cale, din query sau din corp.
- Nu folosi
@RequestBodype ruteGET. - În Postman, verifică tab-ul Body (raw, JSON) înainte să trimiți.
- Scrie un test MockMvc cu
.content(json)pentru fiecare rută care primește corp.
Întrebări frecvente
Pot avea un corp opțional?
Da, @RequestBody(required = false). Parametrul e atunci null când corpul lipsește, deci tratează cazul în cod.
Pot trimite corp într-un GET?
Tehnic se poate, dar multe servere și proxy-uri îl ignoră. Pentru căutări complexe folosește parametri sau un POST /cautare.
Erori înrudite
Required request parameter 'pagina' for method parameter type int is not present Metoda are un parametru @RequestParam obligatoriu, iar cererea nu îl conține în query (?pagina=1), deci Spring răspunde 400. Trimite parametrul, sau fă-l opțional cu defaultValue = "0" / required = false. Content-Type 'text/plain;charset=UTF-8' is not supported Clientul trimite corpul cu un Content-Type pe care metoda nu îl poate citi (de exemplu text/plain la un @RequestBody care așteaptă JSON), deci Spring răspunde 415 Unsupported Media Type. Trimite antetul Content-Type: application/json sau primește textul ca String. JSON parse error: Unexpected character ('}' (code 125)): was expecting double-quote to start field name JSON-ul primit nu este valid: Jackson a găsit un caracter care nu are voie să fie acolo, cel mai des o virgulă înainte de } sau ]. Corectează textul JSON (fără virgulă finală, cheile între ghilimele duble). Î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.
