Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "string cheie" was not provided from header.
Un parametru marcat [FromHeader] e obligatoriu, iar cererea nu are antetul cu numele căutat. De obicei numele diferă: fără Name, se caută antetul cu numele parametrului C#. Folosește [FromHeader(Name = "X-Api-Key")] sau fă parametrul opțional (string?).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
[FromHeader] citește o valoare din antetele HTTP ale cererii. Fără Name, numele antetului căutat este chiar numele parametrului C# (cheie, apiKey), ceea ce aproape niciodată nu corespunde antetelor reale, care au forma X-Api-Key, X-Tenant-Id, Accept-Language. Când antetul lipsește și parametrul e obligatoriu (string fără ?, int fără valoare implicită), răspunsul e 400 cu mesajul de mai sus; în mesaj apare numele parametrului C#, nu al antetului.
Numele antetelor nu țin cont de majuscule. Alte cauze: un proxy sau CORS care elimină antetul, un client care îl trimite doar la unele cereri, sau un middleware care l-a citit și l-a scos. În controllerele cu [ApiController] aceeași situație produce un 400 de validare (The cheie field is required.).
De ce apare: cauzele frecvente
1Lipsește Name în atribut
app.MapGet("/rapoarte", ([FromHeader] string apiKey) => "ok");
// clientul trimite X-Api-Key: abcapp.MapGet("/rapoarte", ([FromHeader(Name = "X-Api-Key")] string apiKey) => "ok");Fără Name, binding-ul caută antetul apiKey, nu X-Api-Key.
2Antet opțional tratat ca obligatoriu
app.MapGet("/produse", ([FromHeader(Name = "Accept-Language")] string limba) => limba);app.MapGet("/produse", ([FromHeader(Name = "Accept-Language")] string? limba) => limba ?? "ro");Antetele pe care nu le trimit toți clienții trebuie declarate nullable, cu o valoare implicită în cod.
Repară eroarea, direct în pagină
Clientul trimite antetul X-Api-Key: magazin-123, dar GET /rapoarte răspunde 400 cu Required parameter "string cheie" was not provided from header.. Repară legarea antetului ca răspunsul să fie Raport pentru cheia magazin-123.
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/rapoarte", ([FromHeader] string cheie) => $"Raport pentru cheia {cheie}");
app.Run();GET /rapoarte → 200 OK Raport pentru cheia magazin-123
Indiciu
Atributul caută acum un antet cu numele parametrului C#.
Reparația
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/rapoarte", ([FromHeader(Name = "X-Api-Key")] string cheie) => $"Raport pentru cheia {cheie}");
app.Run();De ce merge
Fără Name, [FromHeader] căuta un antet numit cheie, care nu exista în cerere, deci parametrul obligatoriu rămânea fără valoare și binding-ul dădea 400. [FromHeader(Name = "X-Api-Key")] indică antetul real, iar parametrul C# își poate păstra numele cheie. Numele antetelor nu țin cont de majuscule.
Alte forme ale mesajului
Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "int tenantId" was not provided from header.Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "int tenantId" from "abc".
Cum o eviți pe viitor
- Scrie mereu
Namela[FromHeader], cu numele exact al antetului. - Pentru chei API sau tenant, verifică antetul într-un middleware sau endpoint filter comun, nu în fiecare handler.
- Declară nullable antetele opționale și dă-le o valoare implicită.
- Testează endpoint-ul și cu, și fără antet.
Întrebări frecvente
Contează majusculele la numele antetului?
Nu. HTTP tratează numele antetelor fără să țină cont de majuscule, deci x-api-key și X-Api-Key sunt același antet.
De ce mesajul spune „string cheie” și nu numele antetului?
Mesajul descrie parametrul C# care nu a putut fi completat. Ca să afli ce antet se căuta, uită-te la atributul [FromHeader] al acelui parametru.
Erori înrudite
error CS0246: The type or namespace name 'FromHeaderAttribute' could not be found (are you missing a using directive or an assembly reference?) Atributele [FromHeader], [FromQuery], [FromRoute], [FromBody] și [FromServices] sunt în namespace-ul Microsoft.AspNetCore.Mvc, chiar și în Minimal APIs. Adaugă using Microsoft.AspNetCore.Mvc; în Program.cs sau scrie numele complet al atributului. 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. Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "int pretMax" from "99.90". Valoarea primită în query, rută sau antet nu poate fi convertită în tipul parametrului (de exemplu 99.90 în int, abc în int). Alege tipul potrivit datelor (decimal pentru prețuri) sau o constrângere de rută, iar pentru intrări greșite răspunsul 400 e corect. Î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.
