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

Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "int id" was not provided from route.

Pe scurt

Ruta are un parametru opțional ({id?}), dar handler-ul îl declară obligatoriu (int id). Când cererea vine fără acel segment, binding-ul nu are valoare și răspunde 400. Fă parametrul nullable (int? id) sau dă-i o valoare implicită.

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

Ce înseamnă

Un parametru marcat cu ? în șablon (/produse/{id?}) permite ca ruta să se potrivească și fără segment: atât /produse, cât și /produse/3. Dar tipul parametrului C# decide dacă handler-ul acceptă lipsa valorii. int id este obligatoriu: nu poate fi null și nu are valoare implicită, deci când segmentul lipsește, Minimal APIs oprește cererea cu 400 Bad Request și, în Development, cu textul Required parameter "int id" was not provided from route..

Aceeași regulă se aplică la string cu nullable reference types activate: string nume e obligatoriu, string? nume e opțional. În Production corpul răspunsului e gol, deci vezi doar 400, iar motivul apare în loguri la nivel Debug.

De ce apare: cauzele frecvente

1Rută opțională, parametru obligatoriu

Greșit
C#
app.MapGet("/produse/{id?}", (int id) => produse.First(p => p.Id == id));
Corect
C#
app.MapGet("/produse/{id?}", (int? id) =>
    id is null ? Results.Ok(produse) : Results.Ok(produse.First(p => p.Id == id)));

int? acceptă lipsa valorii, iar handler-ul decide ce face în acest caz.

2Valoare implicită în rută, dar nu în handler

Greșit
C#
app.MapGet("/pagina/{nr?}", (int nr) => nr);
Corect
C#
app.MapGet("/pagina/{nr=1}", (int nr) => nr);

{nr=1} dă valoarea implicită direct din rută, deci parametrul are mereu o valoare.

Repară tu

Repară eroarea, direct în pagină

GET /produse răspunde 400 Bad Request cu Required parameter "int id" was not provided from route., iar GET /produse/2 merge. Repară handler-ul ca fără id să întoarcă toate produsele, iar cu id să întoarcă doar produsul cerut.

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?}", (int id) =>
    Results.Ok(produse.Where(p => p.Id == id)));

app.Run();

public record Produs(int Id, string Nume);
După reparație, programul afișează
GET /produse → 200 OK
[{"id":1,"nume":"Laptop"},{"id":2,"nume":"Mouse"}]
GET /produse/2 → 200 OK
[{"id":2,"nume":"Mouse"}]
Indiciu

Parametrul C# trebuie să poată exprima lipsa id-ului.

Alte forme ale mesajului

  • Microsoft.AspNetCore.Http.BadHttpRequestException: Required parameter "string categorie" was not provided from route.

Cum o eviți pe viitor

  • Pentru fiecare {x?} din rută, declară parametrul nullable (int?, string?) sau cu valoare implicită.
  • Gândește-te dacă ai nevoie de rută opțională: de multe ori două endpoint-uri (/produse și /produse/{id:int}) sunt mai clare.
  • Testează și varianta fără segment.

Întrebări frecvente

De ce primesc 400 și nu 404?

Ruta s-a potrivit (segmentul era opțional), deci nu e 404. Problema apare la legarea parametrilor, după rutare, iar acolo lipsa unei valori obligatorii dă 400.

{id?} și int id = 0 în handler funcționează?

Da: un parametru cu valoare implicită C# e opțional pentru binding. Dar valoarea 0 se confundă ușor cu un id real; int? face cazul „lipsește” explicit.

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.