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

404 Not Found (nicio rută nu se potrivește cu calea cererii)

Pe scurt

ASP.NET Core nu a găsit niciun endpoint pentru calea cererii, așa că răspunde 404 fără corp. Compară caracter cu caracter calea cerută cu rutele din MapGet / MapGroup / [Route]: o literă în plus, un prefix uitat sau un singular în loc de plural sunt cele mai dese cauze.

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

Ce înseamnă

Rutarea compară calea cererii (/api/produse/5) cu toate șabloanele înregistrate. Dacă niciunul nu se potrivește, cererea trece de tot pipeline-ul și serverul răspunde 404 Not Found cu corp gol. Spre deosebire de alte erori, nu primești niciun mesaj și nicio excepție în consolă: e doar statusul.

Potrivirea nu ține cont de majuscule (/Produse = /produse) și acceptă o bară finală, dar segmentele trebuie să fie exact aceleași. Prefixul unui MapGroup("/api") se lipește în fața fiecărei rute din grup, deci clientul trebuie să-l includă. Pentru depanare: în Development, endpoint-urile se văd în Swagger sau le poți lista injectând EndpointDataSource; în logurile cu nivel Debug pentru Microsoft.AspNetCore.Routing apare „Request did not match any endpoints”.

De ce apare: cauzele frecvente

1Singular în loc de plural sau literă greșită

Greșit
C#
app.MapGet("/produs", () => produse);
// clientul cere GET /produse
Corect
C#
app.MapGet("/produse", () => produse);

Segmentele se compară exact (fără să conteze majusculele). /produs și /produse sunt rute diferite.

2Prefixul grupului uitat de client sau dublat

Greșit
C#
var api = app.MapGroup("/api");
api.MapGet("/api/comenzi", () => comenzi);
// ruta reală devine /api/api/comenzi
Corect
C#
var api = app.MapGroup("/api");
api.MapGet("/comenzi", () => comenzi);
// GET /api/comenzi

Rutele din grup sunt relative la prefixul grupului; repetarea lui produce o cale pe care nu o cere nimeni.

3Versiunea sau segmentul din mijloc lipsește

Greșit
C#
app.MapGet("/v1/clienti/{id:int}", (int id) => id);
// clientul cere GET /clienti/1
Corect
C#
app.MapGet("/v1/clienti/{id:int}", (int id) => id);
// clientul cere GET /v1/clienti/1

Toate segmentele fixe din șablon trebuie să existe în cerere.

Repară tu

Repară eroarea, direct în pagină

Aplicația mobilă cere GET /api/comenzi și GET /api/comenzi/2, dar ambele cereri primesc 404 Not Found. Repară rutele din grup (fără să schimbi cererile) ca prima să întoarcă toate comenzile, iar a doua comanda cu id-ul 2.

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

var comenzi = new List<Comanda> { new(1, "Ana", 250m), new(2, "Mihai", 99m) };

var api = app.MapGroup("/api");
api.MapGet("/api/comanda", () => comenzi);
api.MapGet("/api/comanda/{id:int}", (int id) => comenzi.FirstOrDefault(c => c.Id == id));

app.Run();

public record Comanda(int Id, string Client, decimal Total);
După reparație, programul afișează
GET /api/comenzi → 200 OK
[{"id":1,"client":"Ana","total":250},{"id":2,"client":"Mihai","total":99}]
GET /api/comenzi/2 → 200 OK
{"id":2,"client":"Mihai","total":99}
Indiciu

Uită-te la calea completă pe care o produce fiecare rută din grup, inclusiv prefixul.

Alte forme ale mesajului

  • HTTP/1.1 404 Not Found (Content-Length: 0)
  • Request did not match any endpoints
  • Request reached the end of the middleware pipeline without being handled by application code. Request path: GET http://localhost:5000/produs, Response status code: 404

Cum o eviți pe viitor

  • Ține rutele unei resurse într-un singur MapGroup și scrie în grup doar segmentele relative.
  • Folosește substantive la plural, consecvent (/produse, /comenzi).
  • Testează fiecare endpoint dintr-un fișier .http sau din Swagger, nu doar din aplicația client.
  • Activează UseStatusCodePages() cu AddProblemDetails() ca 404-ul să aibă un corp care spune ce s-a întâmplat.

Întrebări frecvente

De ce 404-ul nu are niciun mesaj?

Implicit, ASP.NET Core nu scrie corp pentru 404-urile produse de rutare. Cu builder.Services.AddProblemDetails() și app.UseStatusCodePages() primești un JSON ProblemDetails cu status: 404.

Cum deosebesc „ruta nu există” de „resursa nu există”?

Ambele dau 404. Al doilea vine din codul tău (Results.NotFound()), deci poți pune un corp explicativ, de exemplu „Produsul 9 nu există”, ca să fie clar că ruta e bună.

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.