...
Eroare ASP.NET Core · Controllere, validare și ProblemDetails

A non-empty request body is required.

Pe scurt

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

Greșit
C#
[HttpPost("{id:int}/anulare")]
public IActionResult Anuleaza(int id, MotivAnulare motiv) => ...
// POST /api/comenzi/5/anulare  (fără corp)
Corect
C#
[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

Greșit
C#
fetch("/api/produse", { method: "POST", body: produs })
Corect
C#
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ă tu

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.

Codul care dă eroarea
C#
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"}");
}
După reparație, programul afișează
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.

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 și Content-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

← Toate erorile ASP.NET Core

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ță 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.