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

System.InvalidOperationException: Body was inferred but the method does not allow inferred body parameters.

Pe scurt

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]

Greșit
C#
app.MapGet("/produse", (Filtru f) => ...);
record Filtru(string? Categorie, int Pagina = 1);
Corect
C#
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

Greșit
C#
var app = builder.Build();
app.MapGet("/stoc", (ServiciuStoc s) => s.Total());
Corect
C#
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

Greșit
C#
app.MapGet("/produse", (List<int> ids) => ids);
Corect
C#
app.MapGet("/produse", (int[] ids) => ids);
// GET /produse?ids=1&ids=2

Din query se leagă tablourile de tipuri simple; List<int> e tratat ca tip complex.

Repară tu

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.

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

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

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