...
Eroare ASP.NET Core · Rutare: 404, 405 și rute ambigue

System.InvalidOperationException: The constraint reference 'integer' could not be resolved to a type. Register the constraint type with 'Microsoft.AspNetCore.Routing.RouteOptions.ConstraintMap'.

Pe scurt

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

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

Constrângerea pentru numere întregi se numește int (sau long).

2Constrângere pentru string

Greșit
C#
app.MapGet("/categorii/{nume:string}", (string nume) => nume);
Corect
C#
app.MapGet("/categorii/{nume}", (string nume) => nume);

Orice segment este deja text; constrângerea string nu există.

3Constrângere proprie neînregistrată

Greșit
C#
app.MapGet("/coduri/{cod:codprodus}", (string cod) => cod);
Corect
C#
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ă tu

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.

Codul care dă eroarea
C#
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);
După reparație, programul afișează
GET /produse/2 → 200 OK
{"id":2,"nume":"Mouse"}
GET /categorii/accesorii → 200 OK
Categoria accesorii
Indiciu

Verifică numele constrângerilor: unul nu există deloc, iar altul nu e necesar.

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

← 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.