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

404 Not Found pentru un endpoint mapat după app.Run()

Pe scurt

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

Greșit
C#
app.MapGet("/produse", () => produse);
app.Run();

app.MapGet("/categorii", () => categorii);
Corect
C#
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()

Greșit
C#
app.Run();
app.UseHttpsRedirection();
Corect
C#
app.UseHttpsRedirection();
app.Run();

Pipeline-ul se construiește la pornire; ce adaugi după Run() nu face parte din el.

Repară tu

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.

Codul care dă eroarea
C#
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);
După reparație, programul afișează
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.

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 de Run().
  • După ce adaugi un endpoint, cere-l o dată din .http sau 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

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