A non-empty request body is required.
Acțiunea are un parametru citit din corp (un obiect complex), dar cererea a venit fără corp. [ApiController] răspunde 400 cu eroarea sub cheia goală "". Trimite corpul JSON sau, dacă acțiunea nu are nevoie de el, scoate parametrul ori ia valoarea din rută sau query.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În controllerele [ApiController], un parametru de tip complex (clasă, record) e citit implicit din corpul cererii ([FromBody] dedus). Dacă cererea nu are corp deloc (de exemplu un POST gol, trimis de un buton care doar „declanșează” o acțiune), formatter-ul JSON raportează A non-empty request body is required. sub cheia "" (șirul gol) în errors, iar răspunsul e 400.
Cazuri tipice: o acțiune de tip comandă (POST /api/comenzi/5/anulare) care primește un DTO de care nu are de fapt nevoie; clientul uită să trimită JSON.stringify(...); un proxy elimină corpul.
Soluții: dacă datele sunt obligatorii, clientul trebuie să le trimită; dacă sunt opționale, ia-le din query ([FromQuery] string? motiv) sau elimină parametrul. Opțiunea [FromBody(EmptyBodyBehavior = EmptyBodyBehavior.Allow)] permite și corp gol, cu parametrul null.
De ce apare: cauzele frecvente
1Acțiune de tip comandă cu DTO inutil
[HttpPost("{id:int}/anulare")]
public IActionResult Anuleaza(int id, MotivAnulare motiv) => ...
// POST /api/comenzi/5/anulare (fără corp)[HttpPost("{id:int}/anulare")]
public IActionResult Anuleaza(int id, [FromQuery] string? motiv) => ...Motivul opțional vine din query, iar acțiunea nu mai cere un corp.
2Clientul trimite obiectul fără serializare
fetch("/api/produse", { method: "POST", body: produs })fetch("/api/produse", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(produs) })Fără JSON.stringify și antetul corect, corpul ajunge gol sau într-un format necunoscut.
Repară eroarea, direct în pagină
Butonul „Anulează” trimite POST /api/comenzi/5/anulare fără corp, iar acțiunea răspunde 400 (A non-empty request body is required.), pentru că așteaptă un MotivAnulare în corp. Ia motivul, opțional, din query ([FromQuery] string? motiv), ca ambele cereri să primească 200.
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
public class MotivAnulare
{
public string? Motiv { get; set; }
}
[ApiController]
[Route("api/comenzi")]
public class ComenziController : ControllerBase
{
// TODO: acțiunea nu trebuie să ceară un corp
[HttpPost("{id:int}/anulare")]
public IActionResult Anuleaza(int id, MotivAnulare motiv) =>
Ok($"Comanda {id} anulată: {motiv.Motiv ?? "fără motiv"}");
}POST /api/comenzi/5/anulare → 200 OK Comanda 5 anulată: fără motiv POST /api/comenzi/6/anulare?motiv=dublura → 200 OK Comanda 6 anulată: dublura
Indiciu
Scoate parametrul complex din acțiune și adaugă un parametru string? citit din query.
Reparația
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
public class MotivAnulare
{
public string? Motiv { get; set; }
}
[ApiController]
[Route("api/comenzi")]
public class ComenziController : ControllerBase
{
[HttpPost("{id:int}/anulare")]
public IActionResult Anuleaza(int id, [FromQuery] string? motiv) =>
Ok($"Comanda {id} anulată: {motiv ?? "fără motiv"}");
}De ce merge
Un parametru complex într-un controller [ApiController] e citit din corp, iar corpul lipsă dă 400. Motivul anulării e o informație mică și opțională, potrivită pentru query string. Cu [FromQuery] string? motiv, acțiunea rulează și fără corp; dacă motivul lipsește, folosim un text implicit.
Alte forme ale mesajului
"errors":{"":["A non-empty request body is required."]}
Cum o eviți pe viitor
- Primește un DTO în corp doar când acțiunea chiar are nevoie de date.
- Pentru parametri opționali mici, folosește query string-ul.
- Testează endpoint-urile și cu un corp gol.
- În clientul JavaScript, folosește întotdeauna
JSON.stringifyșiContent-Type: application/json.
Întrebări frecvente
De ce cheia erorii este goală?
Eroarea privește tot corpul, nu o proprietate anume. Modelul de rădăcină are prefixul gol, deci cheia din errors e "".
Ce face EmptyBodyBehavior.Allow?
Permite un corp lipsă pentru acel parametru: acțiunea rulează, iar parametrul e null (sau valoarea implicită). Corpul prezent, dar invalid, dă în continuare 400.
Erori înrudite
The comanda field is required. Cheia erorii e numele parametrului acțiunii (comanda), nu al unei proprietăți: tot corpul nu a putut fi transformat în obiect, deci parametrul a rămas null. Caută lângă ea a doua eroare (cu $) care spune de ce: JSON invalid, listă în loc de obiect, tip greșit. {"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"Cantitate":["The field Cantitate must be between 1 and 100."]}} Un controller cu [ApiController] a validat automat datele primite și a găsit erori, așa că a răspuns 400 cu ValidationProblemDetails înainte să ruleze acțiunea. Proprietatea errors spune, pentru fiecare câmp, ce regulă a picat. Corectează datele trimise sau regula greșită din model. The JSON value could not be converted to System.Decimal. Path: $.pret | LineNumber: 0 | BytePositionInLine: 15. System.Text.Json nu poate pune valoarea din JSON în tipul proprietății: de exemplu prețul vine ca "99,50" (cu virgulă) într-un decimal, sau un enum vine ca nume fără JsonStringEnumConverter. Path arată exact câmpul. Trimite formatul corect sau configurează serializatorul să-l accepte. Învață ASP.NET Core de la zero, cu exerciții la fiecare lecție
Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.
