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().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
app.Run() nu este doar o declarație de final: pornește Kestrel și așteaptă până când procesul e oprit (Ctrl+C, SIGTERM). Tot codul de după el rulează abia la oprire, când nu mai are niciun efect. Un app.MapGet(...) pus după app.Run() nu ajunge niciodată să înregistreze ruta în timpul vieții serverului, deci cererile către ea primesc 404.
Greșeala apare când adaugi un endpoint nou la finalul fișierului, sub app.Run(), mai ales în Program.cs-uri lungi cu clase declarate la sfârșit. Compilatorul nu te avertizează (codul e valid), iar celelalte endpoint-uri merg normal, ceea ce face problema greu de observat. Același lucru se întâmplă cu middleware-urile (app.Use...) adăugate după Run().
De ce apare: cauzele frecvente
1Endpoint nou adăugat la finalul fișierului
app.MapGet("/produse", () => produse);
app.Run();
app.MapGet("/categorii", () => categorii);app.MapGet("/produse", () => produse);
app.MapGet("/categorii", () => categorii);
app.Run();Înregistrarea trebuie să se întâmple înainte ca serverul să pornească și să blocheze execuția.
2Middleware pus după Run()
app.Run();
app.UseHttpsRedirection();app.UseHttpsRedirection();
app.Run();Pipeline-ul se construiește la pornire; ce adaugi după Run() nu face parte din el.
Repară eroarea, direct în pagină
Endpoint-ul GET /categorii a fost adăugat recent, dar răspunde 404 Not Found, în timp ce GET /produse merge. Repară Program.cs ca ambele să răspundă cu listele lor.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<string> { "Laptop", "Mouse" };
var categorii = new List<string> { "Calculatoare", "Accesorii" };
app.MapGet("/produse", () => produse);
app.Run();
app.MapGet("/categorii", () => categorii);GET /produse → 200 OK ["Laptop","Mouse"] GET /categorii → 200 OK ["Calculatoare","Accesorii"]
Indiciu
Gândește-te până unde rulează instrucțiunile din Program.cs cât timp serverul primește cereri.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<string> { "Laptop", "Mouse" };
var categorii = new List<string> { "Calculatoare", "Accesorii" };
app.MapGet("/produse", () => produse);
app.MapGet("/categorii", () => categorii);
app.Run();De ce merge
app.Run() pornește serverul și nu se întoarce până la oprire. MapGet("/categorii"), scris după el, nu se executa înainte de cereri, deci ruta nu exista. Mutat înainte de app.Run(), endpoint-ul face parte din aplicație de la pornire. Declarația record poate rămâne la final, pentru că nu e o instrucțiune.
Alte forme ale mesajului
404 Not Found la o rută definită după await app.RunAsync()
Cum o eviți pe viitor
- Păstrează structura fixă a lui
Program.cs: servicii,Build(), middleware, endpoint-uri,app.Run(), apoi doar declarații de tipuri (clase, record-uri). - Grupează endpoint-urile în metode de extensie (
app.MapProduse();) apelate înainte deRun(). - După ce adaugi un endpoint, cere-l o dată din
.httpsau Swagger.
Întrebări frecvente
De ce compilatorul nu mă avertizează?
Pentru el, app.Run() este un apel obișnuit care se întoarce cândva. Faptul că se întoarce abia la oprirea serverului e comportament la rulare, pe care compilatorul nu-l cunoaște.
Clasele pot sta după app.Run()?
Da, și chiar trebuie: în Program.cs cu top-level statements, declarațiile de tipuri vin după instrucțiuni. Doar instrucțiunile (apeluri Map, Use) nu au efect acolo.
Erori înrudite
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. error CS1929: 'WebApplicationBuilder' does not contain a definition for 'MapGet' and the best extension method overload 'EndpointRouteBuilderExtensions.MapGet(IEndpointRouteBuilder, string, Delegate)' requires a receiver of type 'Microsoft.AspNetCore.Routing.IEndpointRouteBuilder' Ai apelat MapGet pe builder, dar rutele se definesc pe aplicația construită. Mută apelul după var app = builder.Build(); și scrie app.MapGet(...). Pe builder rămân doar serviciile, configurarea și logging-ul. System.InvalidOperationException: Build can only be called once. builder.Build() a fost apelat de două ori pe același WebApplicationBuilder. Un builder produce o singură aplicație: păstrează un singur var app = builder.Build(); și folosește aceeași variabilă app peste tot. Î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.
