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

Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "string termen" was not provided from query string.

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În Minimal APIs, un parametru simplu (string, int, bool, DateTime...) care nu apare în rută este căutat în query string. Dacă tipul nu acceptă lipsa valorii, parametrul e obligatoriu: un int fără valoare implicită și, cu nullable reference types activate (implicit în proiectele noi), un string fără ?. Când cererea nu conține parametrul, handler-ul nu mai rulează: răspunsul e 400 Bad Request, iar în Development corpul conține exact mesajul de mai sus, cu tipul și numele parametrului C#.

În Production corpul e gol, iar motivul apare doar în loguri la nivel Debug. Dacă numele parametrului nu coincide cu ce trimite clientul (q față de termen), efectul e același: pentru binding, termen lipsește. Tot așa apare eroarea când un parametru pe care îl credeai din rută are alt nume decât segmentul din șablon.

De ce apare: cauzele frecvente

1Parametru opțional declarat obligatoriu

Greșit
C#
app.MapGet("/produse", (string termen) =>
    produse.Where(p => p.Nume.Contains(termen)));
Corect
C#
app.MapGet("/produse", (string? termen) =>
    string.IsNullOrEmpty(termen) ? produse : produse.Where(p => p.Nume.Contains(termen)));

string? spune că parametrul poate lipsi; handler-ul decide ce face atunci.

2Numele din query diferă de numele parametrului

Greșit
C#
// clientul cere /produse?pe-pagina=20
app.MapGet("/produse", (int pePagina) => pePagina);
Corect
C#
app.MapGet("/produse", ([FromQuery(Name = "pe-pagina")] int pePagina = 10) => pePagina);

Fără Name, binding-ul caută pePagina. Atributul (din Microsoft.AspNetCore.Mvc) leagă numele real.

3Segment de rută cu alt nume

Greșit
C#
app.MapGet("/comenzi/{nr:int}", (int id) => id);
Corect
C#
app.MapGet("/comenzi/{nr:int}", (int nr) => nr);

id nu există în rută, deci e căutat în query și lipsește.

Repară tu

Repară eroarea, direct în pagină

Căutarea GET /produse trebuie să funcționeze și fără termen (întoarce toate produsele), dar acum răspunde 400 cu Required parameter "string termen" was not provided from query string.. Repară handler-ul ca ambele cereri să răspundă 200.

Codul care dă eroarea
C#
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var produse = new List<string> { "Laptop", "Mouse", "Mousepad" };

app.MapGet("/produse", (string termen) =>
    produse.Where(p => p.Contains(termen, StringComparison.OrdinalIgnoreCase)).ToList());

app.Run();
După reparație, programul afișează
GET /produse → 200 OK
["Laptop","Mouse","Mousepad"]
GET /produse?termen=mouse → 200 OK
["Mouse","Mousepad"]
Indiciu

Parametrul trebuie să poată lipsi, iar codul să trateze cazul.

Alte forme ale mesajului

  • Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "int pagina" was not provided from query string.
  • Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "string Q" was not provided from query string.

Cum o eviți pe viitor

  • Decide pentru fiecare parametru din query dacă e obligatoriu; filtrele și paginarea sunt aproape mereu opționale (string?, int pagina = 1).
  • Când numele din URL nu e un identificator C# valid, folosește [FromQuery(Name = "...")].
  • Pentru mulți parametri de filtrare, grupează-i într-un tip cu [AsParameters] și valori implicite.

Întrebări frecvente

De ce string termen e obligatoriu, deși string poate fi null?

Cu <Nullable>enable</Nullable>, Minimal APIs folosește adnotările: string înseamnă „nu e null”, deci obligatoriu, iar string? înseamnă opțional.

De ce în producție primesc 400 fără niciun text?

Detaliile excepțiilor de binding se scriu în răspuns doar în Development. În producție ai doar statusul; activează AddProblemDetails() și citește logurile ca să vezi motivul.

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.