Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "Filtru filtru" was not provided from body.
Parametrul marcat [FromBody] este obligatoriu, iar cererea a venit fără corp. Dacă datele din corp sunt opționale, declară parametrul nullable ([FromBody] Filtru? filtru) și tratează null în handler; altfel, clientul trebuie să trimită JSON-ul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cu [FromBody] spui explicit că parametrul se citește din corpul cererii. Tipul decide dacă e obligatoriu: un tip non-nullable (Filtru filtru) cere corp, iar unul nullable (Filtru? filtru) sau cu valoare implicită acceptă lipsa lui. Când corpul lipsește (sau are lungimea zero) și parametrul e obligatoriu, răspunsul este 400 cu mesajul de mai sus.
Apare des la endpoint-uri POST de tip „raport” sau „căutare avansată”, unde filtrele sunt opționale, și la clienți care trimit Content-Length: 0 când nu au filtre. Spre deosebire de cazul „Implicit body inferred”, aici sursa a fost aleasă explicit, deci nu e o confuzie cu serviciile: e o decizie despre obligativitate.
De ce apare: cauzele frecvente
1Filtre opționale declarate obligatorii
app.MapPost("/rapoarte", ([FromBody] Filtru filtru) => Genereaza(filtru));app.MapPost("/rapoarte", ([FromBody] Filtru? filtru) => Genereaza(filtru ?? new Filtru(0)));Tipul nullable face corpul opțional; în handler alegi valorile implicite.
2Clientul uită corpul
POST /comenzi
Content-Type: application/jsonPOST /comenzi
Content-Type: application/json
{"produs":"Mouse","cantitate":1}Pentru date obligatorii, reparația e în client: corpul trebuie trimis.
Repară eroarea, direct în pagină
POST /rapoarte poate primi un filtru {"pretMinim": 100}, dar fără corp răspunde 400: Required parameter "Filtru filtru" was not provided from body.. Repară handler-ul ca fără corp să raporteze toate produsele, iar cu filtru doar pe cele cu prețul cel puțin egal.
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs> { new("Mouse", 99m), new("Monitor", 899m), new("Laptop", 3500m) };
app.MapPost("/rapoarte", ([FromBody] Filtru filtru) =>
{
var lista = produse.Where(p => p.Pret >= filtru.PretMinim).ToList();
return $"{lista.Count} produse, total {lista.Sum(p => p.Pret)} lei";
});
app.Run();
public record Produs(string Nume, decimal Pret);
public record Filtru(decimal PretMinim);POST /rapoarte → 200 OK 3 produse, total 4498 lei POST /rapoarte → 200 OK 2 produse, total 4399 lei
Indiciu
Parametrul din corp trebuie să poată fi absent, iar codul să aleagă un filtru implicit.
Reparația
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs> { new("Mouse", 99m), new("Monitor", 899m), new("Laptop", 3500m) };
app.MapPost("/rapoarte", ([FromBody] Filtru? filtru) =>
{
var prag = filtru?.PretMinim ?? 0;
var lista = produse.Where(p => p.Pret >= prag).ToList();
return $"{lista.Count} produse, total {lista.Sum(p => p.Pret)} lei";
});
app.Run();
public record Produs(string Nume, decimal Pret);
public record Filtru(decimal PretMinim);De ce merge
[FromBody] Filtru filtru era obligatoriu, deci cererea fără corp era respinsă înainte de handler. Cu Filtru? filtru, lipsa corpului devine null, iar filtru?.PretMinim ?? 0 alege pragul 0, adică toate produsele. Când corpul există, JSON-ul se deserializează normal și pragul vine din el.
Alte forme ale mesajului
Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "Comanda comanda" was not provided from body.
Cum o eviți pe viitor
- Decide pentru fiecare endpoint dacă are nevoie de corp; filtrele de raport sunt de obicei opționale.
- Pentru filtre simple, preferă
GETcu query string și[AsParameters]. - Testează endpoint-ul și cu o cerere fără corp.
- Documentează în OpenAPI dacă endpoint-ul acceptă cerere fără corp.
Întrebări frecvente
Ce diferență e între [FromBody] Filtru? f și [FromBody(EmptyBodyBehavior = EmptyBodyBehavior.Allow)]?
În Minimal APIs, tipul nullable (sau o valoare implicită) e modul recomandat de a face corpul opțional. EmptyBodyBehavior este opțiunea echivalentă din controllerele MVC.
De ce cu GET nu pot avea corp?
Poți, tehnic, cu [FromBody], dar specificația HTTP nu dă sens corpului la GET, iar multe proxy-uri și clienți îl elimină. Folosește query string sau POST.
Erori înrudite
Microsoft.AspNetCore.Http.BadHttpRequestException: Implicit body inferred for parameter "svc" but no body was provided. Did you mean to use a Service instead? Un parametru de tip clasă nu e înregistrat ca serviciu, așa că Minimal APIs a presupus că vine din corpul cererii, iar cererea nu are corp. De obicei e un serviciu pe care ai uitat să-l înregistrezi: adaugă builder.Services.AddScoped<T>() (sau AddSingleton). Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to read parameter "Produs p" from the request body as JSON. Corpul cererii nu a putut fi deserializat în tipul parametrului: JSON invalid, o valoare de alt tip (1.5 într-un int, text într-un număr) sau un tablou în loc de obiect. Corectează datele trimise sau tipul proprietății, astfel încât să corespundă. Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "string termen" was not provided from query string. Handler-ul are un parametru obligatoriu (string termen, int pagina) care se citește din query string, iar cererea nu l-a trimis. Fă-l opțional (string?, int? sau cu valoare implicită) ori trimite ?termen=... în URL. Î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.
