...
Eroare Spring Boot · Rute și cereri HTTP: 404, 405, 400

Required request body is missing

Pe scurt

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

Greșit
JAVA
POST /abonare?email=ana@exemplu.ro

@PostMapping("/abonare")
String abonare(@RequestBody String email) { ... }
Corect
JAVA
@PostMapping("/abonare")
String abonare(@RequestParam String email) { ... }

Parametrii din query se citesc cu @RequestParam; @RequestBody citește doar corpul.

2Cererea nu are corp deloc

Greșit
JAVA
fetch('/api/comenzi', { method: 'POST' })
Corect
JAVA
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ă tu

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.

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 AbonareController {
    @PostMapping("/abonare")
    String abonare(@RequestBody String email) {
        return "Abonat: " + email;
    }
}
După reparație, programul afișează
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.

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 @RequestBody pe rute GET.
  • Î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

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