System.InvalidOperationException: The constraint reference 'integer' could not be resolved to a type. Register the constraint type with 'Microsoft.AspNetCore.Routing.RouteOptions.ConstraintMap'.
Ai scris în rută o constrângere care nu există, de exemplu {id:integer} sau {id:number}. Folosește numele reale (int, long, guid, bool, decimal, alpha, min, range...) sau înregistrează constrângerea proprie în RouteOptions.ConstraintMap.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
După : dintr-un parametru de rută urmează numele unei constrângeri. ASP.NET Core caută acel nume în RouteOptions.ConstraintMap, un dicționar care asociază nume scurte cu clase (int cu IntRouteConstraint, guid cu GuidRouteConstraint și așa mai departe). Dacă numele nu e în dicționar, excepția apare când se construiește tabela de rutare, adică la prima cerere sau chiar la pornire, și blochează toată aplicația, nu doar ruta greșită.
Numele greșite frecvent: integer, number, string, uuid, date. Corecte sunt int, long, decimal, double, guid, datetime, bool, alpha, plus cele cu argumente (min(1), max(100), range(1,10), length(6), minlength(2), maxlength(50), regex(...)). Pentru text nu ai nevoie de constrângere: {nume} acceptă orice segment.
Mesajul îți spune și cum adaugi o constrângere proprie: înregistrezi tipul ei în ConstraintMap.
De ce apare: cauzele frecvente
1Nume de tip din alte limbaje
app.MapGet("/produse/{id:integer}", (int id) => id);app.MapGet("/produse/{id:int}", (int id) => id);Constrângerea pentru numere întregi se numește int (sau long).
2Constrângere pentru string
app.MapGet("/categorii/{nume:string}", (string nume) => nume);app.MapGet("/categorii/{nume}", (string nume) => nume);Orice segment este deja text; constrângerea string nu există.
3Constrângere proprie neînregistrată
app.MapGet("/coduri/{cod:codprodus}", (string cod) => cod);builder.Services.Configure<RouteOptions>(o =>
o.ConstraintMap["codprodus"] = typeof(CodProdusConstraint));
// ...
app.MapGet("/coduri/{cod:codprodus}", (string cod) => cod);O constrângere proprie (clasă care implementează IRouteConstraint) trebuie înregistrată sub numele folosit în rută.
Repară eroarea, direct în pagină
Aplicația nu pornește: The constraint reference 'integer' could not be resolved to a type. Repară rutele ca GET /produse/2 să întoarcă produsul cu id-ul 2, iar GET /categorii/accesorii să întoarcă textul Categoria accesorii.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs> { new(1, "Laptop"), new(2, "Mouse") };
app.MapGet("/produse/{id:integer}", (int id) => produse.FirstOrDefault(p => p.Id == id));
app.MapGet("/categorii/{nume:string}", (string nume) => $"Categoria {nume}");
app.Run();
public record Produs(int Id, string Nume);GET /produse/2 → 200 OK
{"id":2,"nume":"Mouse"}
GET /categorii/accesorii → 200 OK
Categoria accesoriiIndiciu
Verifică numele constrângerilor: unul nu există deloc, iar altul nu e necesar.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs> { new(1, "Laptop"), new(2, "Mouse") };
app.MapGet("/produse/{id:int}", (int id) => produse.FirstOrDefault(p => p.Id == id));
app.MapGet("/categorii/{nume}", (string nume) => $"Categoria {nume}");
app.Run();
public record Produs(int Id, string Nume);De ce merge
integer nu e o constrângere înregistrată; numele corect pentru numere întregi este int. A doua rută folosea {nume:string}, care ar fi dat aceeași eroare: un segment de rută e deja text, deci {nume} e suficient. Cu ambele șabloane valide, tabela de rutare se construiește și cererile ajung la handlere.
Alte forme ale mesajului
System.InvalidOperationException: The constraint reference 'number' could not be resolved to a type. Register the constraint type with 'Microsoft.AspNetCore.Routing.RouteOptions.ConstraintMap'.System.InvalidOperationException: The constraint reference 'string' could not be resolved to a type. Register the constraint type with 'Microsoft.AspNetCore.Routing.RouteOptions.ConstraintMap'.
Cum o eviți pe viitor
- Reține setul scurt de constrângeri reale:
int,long,guid,bool,decimal,double,datetime,alpha,min,max,range,length,minlength,maxlength,regex. - Nu pune constrângeri pe text; validează formatul în handler.
- Pornește aplicația și cere o rută după fiecare modificare a șabloanelor: eroarea afectează toate rutele.
Întrebări frecvente
De ce pică toată aplicația pentru o singură rută greșită?
Rutele sunt compilate împreună într-o singură structură de potrivire. Dacă un șablon nu se poate construi, nicio rută nu mai poate fi folosită până repari șablonul.
Pot folosi regex în locul unei constrângeri proprii?
Da, de exemplu {cod:regex(^[A-Z]{{2}}\\d{{3}}$)}, dar acoladele din expresie trebuie dublate în șablon. Pentru reguli complicate, o clasă IRouteConstraint e mai ușor de citit și de testat.
Erori înrudite
404 Not Found pe o rută cu constrângere ({id:int}, {nume:alpha}) Valoarea din URL nu respectă constrângerea rutei (de exemplu {termen:alpha} primește iphone15), deci ruta nu se potrivește și răspunsul e 404, nu 400. Alege constrângeri care descriu doar forma valorii și validează restul în handler. System.InvalidOperationException: 'cod' is not a route parameter. Parametrul marcat cu [FromRoute] are alt nume decât parametrul din șablonul rutei (de exemplu ruta are {id}, handler-ul are [FromRoute] int cod). Folosește același nume sau [FromRoute(Name = "id")]. Microsoft.AspNetCore.Routing.Matching.AmbiguousMatchException: The request matched multiple endpoints. Matches: Două rute se potrivesc la fel de bine cu aceeași cerere, de exemplu /clienti/{id} și /clienti/{email}, iar ASP.NET Core nu poate alege și răspunde 500. Fă rutele distincte: o constrângere ({id:int}) sau un segment fix diferit (/clienti/email/{email}). Î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.
