...
Eroare ASP.NET Core · Model binding, JSON, 400 și 415

Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "Filtru filtru" was not provided from body.

Pe scurt

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

Greșit
C#
app.MapPost("/rapoarte", ([FromBody] Filtru filtru) => Genereaza(filtru));
Corect
C#
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

Greșit
C#
POST /comenzi
Content-Type: application/json
Corect
C#
POST /comenzi
Content-Type: application/json

{"produs":"Mouse","cantitate":1}

Pentru date obligatorii, reparația e în client: corpul trebuie trimis.

Repară tu

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.

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

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ă GET cu 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

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