The value 'laptop-gaming' is not valid for id.
Model binding-ul nu a putut converti textul din rută, query sau formular în tipul parametrului: ai cerut int, dar ai primit 'laptop-gaming'. Pune o constrângere de rută ({id:int}) ca valorile greșite să nu ajungă la acțiune, sau trimite valoarea în formatul corect.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul apare în errors al unui răspuns 400 dintr-un controller [ApiController], sub numele parametrului sau al proprietății. Spune că valoarea primită ca text ('laptop-gaming') nu poate fi convertită în tipul cerut (int id, DateTime data, decimal pretMin, bool activ).
În rute, apare des când o rută fără constrângere ([HttpGet("{id}")]) primește altceva decât un număr: ruta se potrivește oricărui text, iar binding-ul pică. Cu o constrângere ({id:int}), un text nenumeric nu se mai potrivește cu ruta, deci poate ajunge la altă acțiune (de exemplu căutarea după slug) sau primește 404.
În query string, apare pentru ?pagina=doi sau ?pret=12,5 (separatorul zecimal acceptat depinde de cultura folosită de binding; în query se folosește cultura invariantă, cu punct).
De ce apare: cauzele frecvente
1Rută fără constrângere de tip
[HttpGet("{id}")]
public IActionResult DupaId(int id) => ...
// GET /api/produse/laptop-gaming -> 400[HttpGet("{id:int}")]
public IActionResult DupaId(int id) => ...
[HttpGet("{slug}")]
public IActionResult DupaSlug(string slug) => ...Constrângerea :int face ca doar numerele să ajungă la DupaId; textul merge la DupaSlug.
2Număr cu virgulă în query
GET /api/produse?pretMin=12,5GET /api/produse?pretMin=12.5Valorile din query și rută sunt convertite cu cultura invariantă, în care separatorul zecimal e punctul.
Repară eroarea, direct în pagină
GET /api/produse/laptop-gaming răspunde 400 (The value 'laptop-gaming' is not valid for id.), pentru că ruta {id} prinde orice text. Adaugă constrângerea :int pe ruta după id și o acțiune nouă [HttpGet("{slug}")] care caută produsul după slug, ca ambele cereri să primească 200.
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
public record Produs(int Id, string Slug, string Nume);
[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
private static readonly List<Produs> produse = [new(1, "laptop-gaming", "Laptop de gaming"), new(2, "mouse-wireless", "Mouse wireless")];
// TODO: doar numere aici
[HttpGet("{id}")]
public IActionResult DupaId(int id) =>
produse.FirstOrDefault(p => p.Id == id) is Produs p ? Ok(p) : NotFound();
// TODO: acțiune pentru căutarea după slug
}GET /api/produse/1 → 200 OK
{"id":1,"slug":"laptop-gaming","nume":"Laptop de gaming"}
GET /api/produse/laptop-gaming → 200 OK
{"id":1,"slug":"laptop-gaming","nume":"Laptop de gaming"}Indiciu
Cu {id:int}, textul nu se mai potrivește cu prima rută și poate ajunge la a doua.
Reparația
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
public record Produs(int Id, string Slug, string Nume);
[ApiController]
[Route("api/produse")]
public class ProduseController : ControllerBase
{
private static readonly List<Produs> produse = [new(1, "laptop-gaming", "Laptop de gaming"), new(2, "mouse-wireless", "Mouse wireless")];
[HttpGet("{id:int}")]
public IActionResult DupaId(int id) =>
produse.FirstOrDefault(p => p.Id == id) is Produs p ? Ok(p) : NotFound();
[HttpGet("{slug}")]
public IActionResult DupaSlug(string slug) =>
produse.FirstOrDefault(p => p.Slug == slug) is Produs p ? Ok(p) : NotFound();
}De ce merge
Fără constrângere, ruta {id} se potrivea și pentru laptop-gaming, iar conversia în int pica cu 400. Constrângerea {id:int} limitează prima acțiune la numere. Textul ajunge la DupaSlug, care primește un string. Rutele cu constrângere au prioritate, deci /api/produse/1 merge în continuare la căutarea după id.
Alte forme ale mesajului
The value 'doi' is not valid for pagina.The value 'abc' is not valid for PretMin.
Cum o eviți pe viitor
- Pune constrângeri de tip pe parametrii de rută (
{id:int},{data:datetime}). - Documentează formatul parametrilor de query (punct zecimal, dată ISO).
- Pentru valori text care pot lipsi, folosește tipuri nullable (
int?). - Întoarce mesaje de eroare clare pentru parametrii de query, ca utilizatorii API-ului să știe formatul așteptat.
Întrebări frecvente
De ce cu {id:int} primesc 404, iar fără primesc 400?
Cu constrângere, ruta nu se potrivește deloc pentru un text, deci nu există endpoint: 404. Fără constrângere, ruta se potrivește, dar conversia parametrului pică: 400.
E diferit de „The value 'x' is invalid.”?
Da. „is not valid for X” apare când textul nu poate fi convertit în tip. „is invalid” apare când conversia a mers, dar valoarea nu e acceptată, de exemplu un număr care nu corespunde niciunei valori dintr-un enum.
Erori înrudite
The value '2' is invalid. Valoarea a putut fi citită, dar nu e acceptată pentru tipul parametrului, cel mai des un număr care nu corespunde niciunei valori dintr-un enum (?stare=2 când enum-ul are doar 0 și 1). Trimite o valoare existentă sau adaugă valoarea lipsă în enum. {"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"Cantitate":["The field Cantitate must be between 1 and 100."]}} Un controller cu [ApiController] a validat automat datele primite și a găsit erori, așa că a răspuns 400 cu ValidationProblemDetails înainte să ruleze acțiunea. Proprietatea errors spune, pentru fiecare câmp, ce regulă a picat. Corectează datele trimise sau regula greșită din model. The JSON value could not be converted to System.Decimal. Path: $.pret | LineNumber: 0 | BytePositionInLine: 15. System.Text.Json nu poate pune valoarea din JSON în tipul proprietății: de exemplu prețul vine ca "99,50" (cu virgulă) într-un decimal, sau un enum vine ca nume fără JsonStringEnumConverter. Path arată exact câmpul. Trimite formatul corect sau configurează serializatorul să-l accepte. Î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.
