System.InvalidOperationException: Body was inferred but the method does not allow inferred body parameters.
Un endpoint GET (sau DELETE) are un parametru de tip complex pe care Minimal APIs l-ar citi din corp, dar aceste metode nu au corp, deci aplicația se oprește la pornire. Folosește [AsParameters] pentru filtre din query, înregistrează tipul ca serviciu sau folosește tipuri simple.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Minimal APIs deduce sursa fiecărui parametru la pornire. Un tip complex (clasă, record, listă) care nu e serviciu înregistrat și nu are atribut este dedus ca body. Pentru GET, DELETE, HEAD și OPTIONS, deducerea corpului nu e permisă, așa că, la construirea endpoint-ului, aplicația aruncă această excepție și nu pornește.
Mesajul continuă cu lista parametrilor (f | Body (Inferred)) și cu întrebarea „Did you mean to register the "Body (Inferred)" parameter(s) as a Service or apply the [FromServices] or [FromBody] attribute?”. Trei cauze tipice: un obiect de filtrare pe care îl voiai din query (soluția: [AsParameters]), un serviciu pe care ai uitat să-l înregistrezi, sau o colecție (List<int> ids) din query, care trebuie declarată ca tablou (int[] ids).
De ce apare: cauzele frecvente
1Obiect de filtrare fără [AsParameters]
app.MapGet("/produse", (Filtru f) => ...);
record Filtru(string? Categorie, int Pagina = 1);app.MapGet("/produse", ([AsParameters] Filtru f) => ...);
record Filtru(string? Categorie, int Pagina = 1);[AsParameters] desface obiectul în parametri separați, citiți din query (sau rută).
2Serviciu neînregistrat
var app = builder.Build();
app.MapGet("/stoc", (ServiciuStoc s) => s.Total());builder.Services.AddSingleton<ServiciuStoc>();
var app = builder.Build();
app.MapGet("/stoc", (ServiciuStoc s) => s.Total());Un tip înregistrat e recunoscut ca serviciu, nu dedus ca body.
3List<T> din query
app.MapGet("/produse", (List<int> ids) => ids);app.MapGet("/produse", (int[] ids) => ids);
// GET /produse?ids=1&ids=2Din query se leagă tablourile de tipuri simple; List<int> e tratat ca tip complex.
Repară eroarea, direct în pagină
Aplicația nu pornește: Body was inferred but the method does not allow inferred body parameters., cu parametrul filtru în listă. Repară endpoint-ul ca GET /produse?categorie=periferice&pretMax=150 să filtreze din query, iar GET /produse să întoarcă toate produsele.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs> { new("Mouse", "periferice", 99m), new("Tastatură", "periferice", 199m), new("Laptop", "calculatoare", 3500m) };
app.MapGet("/produse", (Filtru filtru) =>
produse.Where(p => (filtru.Categorie is null || p.Categorie == filtru.Categorie)
&& (filtru.PretMax is null || p.Pret <= filtru.PretMax)).ToList());
app.Run();
public record Produs(string Nume, string Categorie, decimal Pret);
public record Filtru(string? Categorie, decimal? PretMax);GET /produse?categorie=periferice&pretMax=150 → 200 OK
[{"nume":"Mouse","categorie":"periferice","pret":99}]
GET /produse → 200 OK
[{"nume":"Mouse","categorie":"periferice","pret":99},{"nume":"Tastatură","categorie":"periferice","pret":199},{"nume":"Laptop","categorie":"calculatoare","pret":3500}]Indiciu
Proprietățile obiectului de filtrare trebuie să devină parametri citiți din query string.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs> { new("Mouse", "periferice", 99m), new("Tastatură", "periferice", 199m), new("Laptop", "calculatoare", 3500m) };
app.MapGet("/produse", ([AsParameters] Filtru filtru) =>
produse.Where(p => (filtru.Categorie is null || p.Categorie == filtru.Categorie)
&& (filtru.PretMax is null || p.Pret <= filtru.PretMax)).ToList());
app.Run();
public record Produs(string Nume, string Categorie, decimal Pret);
public record Filtru(string? Categorie, decimal? PretMax);De ce merge
Filtru e un tip complex, deci Minimal APIs îl deducea din corp, ceea ce nu e permis la GET. [AsParameters] desface record-ul în parametri separați: Categorie și PretMax se citesc din query și, fiind nullable, sunt opționale. Handler-ul aplică doar filtrele primite.
Alte forme ale mesajului
System.InvalidOperationException: Body was inferred but the method does not allow inferred body parameters. Below is the list of parameters that we found: f | Body (Inferred) Did you mean to register the "Body (Inferred)" parameter(s) as a Service or apply the [FromServices] or [FromBody] attribute?
Cum o eviți pe viitor
- Pentru filtre și paginare în
GET, grupează parametrii într-un record cu[AsParameters]. - Înregistrează serviciile înainte de
Build()și injectează tipul înregistrat. - Pentru liste din query, folosește tablouri (
string[] tag). - Pornește aplicația după fiecare endpoint nou: eroarea apare imediat.
Întrebări frecvente
De ce eroarea apare la pornire, nu la cerere?
Minimal APIs construiește delegații de cerere pentru toate endpoint-urile la pornire (sau la prima cerere), iar deducerea surselor face parte din acest pas.
Pot pune [FromBody] pe un GET?
Tehnic da, iar eroarea dispare, dar e o idee proastă: mulți clienți și proxy-uri nu trimit corp la GET. Folosește query string.
Erori înrudite
System.InvalidOperationException: Failure to infer one or more parameters. Minimal APIs a dedus mai mulți parametri ca venind din corp, dar o cerere are un singur corp, deci aplicația nu pornește. De obicei unul dintre ei e un serviciu neînregistrat; înregistrează-l sau grupează datele într-un singur tip. 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: 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.
