404 Not Found (nicio rută nu se potrivește cu calea cererii)
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ă
app.MapGet("/produs", () => produse);
// clientul cere GET /produseapp.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
var api = app.MapGroup("/api");
api.MapGet("/api/comenzi", () => comenzi);
// ruta reală devine /api/api/comenzivar api = app.MapGroup("/api");
api.MapGet("/comenzi", () => comenzi);
// GET /api/comenziRutele 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
app.MapGet("/v1/clienti/{id:int}", (int id) => id);
// clientul cere GET /clienti/1app.MapGet("/v1/clienti/{id:int}", (int id) => id);
// clientul cere GET /v1/clienti/1Toate segmentele fixe din șablon trebuie să existe în cerere.
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.
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);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.
Reparația
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("/comenzi", () => comenzi);
api.MapGet("/comenzi/{id:int}", (int id) => comenzi.FirstOrDefault(c => c.Id == id));
app.Run();
public record Comanda(int Id, string Client, decimal Total);De ce merge
Prefixul /api din MapGroup se adaugă automat în fața rutelor din grup. Rutele scrise /api/comanda deveneau /api/api/comanda, iar în plus erau la singular, deci nu se potriveau cu /api/comenzi. Cu rute relative (/comenzi, /comenzi/{id:int}), căile reale sunt exact cele cerute de client.
Alte forme ale mesajului
HTTP/1.1 404 Not Found (Content-Length: 0)Request did not match any endpointsRequest 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
.httpsau din Swagger, nu doar din aplicația client. - Activează
UseStatusCodePages()cuAddProblemDetails()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
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. 405 Method Not Allowed Calea există, dar nu pentru metoda HTTP folosită: de exemplu există GET /produse, iar clientul trimite POST /produse. Adaugă endpoint-ul pentru metoda respectivă (MapPost, MapPut, MapDelete) sau corectează metoda din client. 404 Not Found pentru un endpoint mapat după app.Run() app.Run() pornește serverul și blochează până la oprirea aplicației, deci liniile scrise după el nu rulează cât timp aplicația primește cereri. Endpoint-urile definite acolo nu există și răspund 404. Mută toate MapGet / MapPost înainte de app.Run(). 404 Not Found la un controller (lipsește app.MapControllers()) Controllerul compilează și AddControllers() e prezent, dar fără app.MapControllers() rutele din atributele [Route] și [HttpGet] nu sunt create, deci orice cerere către controller primește 404. Adaugă app.MapControllers(); după Build(). Î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.
