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

Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "Stare stare" from "deschisa".

Pe scurt

Minimal APIs convertește enum-urile din query și rută cu Enum.TryParse sensibil la majuscule, deci deschisa nu se potrivește cu Deschisa și răspunsul e 400. Primește valoarea ca string și folosește Enum.TryParse(valoare, ignoreCase: true, out ...).

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

Ce înseamnă

Pentru un parametru de tip enum, Minimal APIs folosește Enum.TryParse<T>(valoare, out rezultat) fără opțiunea ignoreCase, deci comparația ține cont de majuscule: ?stare=Deschisa merge, ?stare=deschisa și ?stare=DESCHISA dau 400. Pe de altă parte, sunt acceptate și numerele, chiar și cele care nu corespund niciunui membru (?stare=99), ceea ce poate băga valori invalide în cod.

Controllerele MVC se comportă diferit: acolo enum-urile sunt case-insensitive, ceea ce surprinde la mutarea unui endpoint dintr-un model în altul. Pentru API-uri publice, unde clienții scriu valorile cu litere mici, e mai sigur să primești textul și să-l convertești tu, cu ignoreCase: true și cu verificarea Enum.IsDefined.

De ce apare: cauzele frecvente

1Valoare cu litere mici

Greșit
C#
app.MapGet("/comenzi", (Stare stare) => comenzi.Where(c => c.Stare == stare));
// GET /comenzi?stare=deschisa
Corect
C#
app.MapGet("/comenzi", (string stare) =>
    Enum.TryParse<Stare>(stare, ignoreCase: true, out var s)
        ? Results.Ok(comenzi.Where(c => c.Stare == s))
        : Results.BadRequest($"Stare necunoscută: {stare}"));

Conversia proprie ignoră majusculele și dă un mesaj clar pentru valorile greșite.

2Numele afișat diferit de numele membrului

Greșit
C#
enum Stare { InLivrare }
// clientul trimite ?stare=in-livrare
Corect
C#
// acceptă ambele forme: elimină cratimele înainte de TryParse
Enum.TryParse<Stare>(stare.Replace("-", ""), true, out var s);

TryParse cunoaște doar numele membrilor C#. Formatul din URL trebuie normalizat.

Repară tu

Repară eroarea, direct în pagină

Aplicația mobilă cere GET /comenzi?stare=deschisa (cu litere mici) și primește 400: Failed to bind parameter "Stare stare" from "deschisa".. Repară handler-ul ca valoarea să fie acceptată indiferent de majuscule, iar o stare necunoscută să dea 400 cu textul Stare necunoscută: <valoare>.

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

var comenzi = new List<Comanda> { new(1, Stare.Deschisa), new(2, Stare.Livrata), new(3, Stare.Deschisa) };

app.MapGet("/comenzi", (Stare stare) =>
    Results.Ok(comenzi.Where(c => c.Stare == stare).Select(c => c.Id)));

app.Run();

public enum Stare { Deschisa, Livrata }
public record Comanda(int Id, Stare Stare);
După reparație, programul afișează
GET /comenzi?stare=deschisa → 200 OK
[1,3]
GET /comenzi?stare=LIVRATA → 200 OK
[2]
GET /comenzi?stare=anulata → 400 Bad Request
"Stare necunoscută: anulata"
Indiciu

Primește textul și fă conversia în enum tu, cu opțiunea care ignoră majusculele.

Alte forme ale mesajului

  • Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "Nullable<Stare> stare" from "anulata".
  • Microsoft.AspNetCore.Http.BadHttpRequestException: Failed to bind parameter "Categorie categorie" from "carti".

Cum o eviți pe viitor

  • Pentru enum-uri în URL, primește string? și convertește cu Enum.TryParse(..., ignoreCase: true, ...), apoi verifică Enum.IsDefined.
  • Documentează valorile permise (OpenAPI le listează automat pentru enum-uri).
  • Pentru corpul JSON, adaugă JsonStringEnumConverter ca valorile să circule ca text.
  • Scrie un test pentru valori cu litere mici și mari.

Întrebări frecvente

De ce ?stare=99 trece, iar ?stare=deschisa nu?

Enum.TryParse acceptă orice număr întreg (enum-urile sunt numere în spate) și doar numele exacte ale membrilor. Verifică cu Enum.IsDefined dacă vrei să respingi numerele fără membru.

În controllere merge cu litere mici. De ce?

Model binding-ul MVC folosește alt convertor, care ignoră majusculele pentru enum-uri. Minimal APIs folosește direct Enum.TryParse fără ignoreCase.

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.