...
Eroare ASP.NET Core · Middleware, pipeline și excepții

System.InvalidOperationException: The exception handler configured on ExceptionHandlerOptions produced a 404 status response. This InvalidOperationException containing the original exception was thrown since this is often due to a misconfigured ExceptionHandlingPath. If the exception handler is expected to return 404 status responses then set AllowStatusCode404Response to true.

Pe scurt

Ai configurat UseExceptionHandler("/eroare"), dar la calea /eroare nu există niciun endpoint, așa că re-executarea cererii a dat 404. Adaugă endpoint-ul de eroare (de exemplu app.Map("/eroare", ...) care întoarce Results.Problem) sau folosește AddProblemDetails cu UseExceptionHandler().

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

Ce înseamnă

Cu app.UseExceptionHandler("/eroare"), la o excepție neprinsă middleware-ul schimbă calea cererii în /eroare și o trimite din nou prin pipeline. Dacă nicio rută nu corespunde (endpoint-ul nu există, e mapat doar pentru GET deși cererea inițială era POST, sau calea diferă), rezultatul e 404.

Din .NET 8, un 404 produs de handler-ul de excepții e considerat o configurare greșită: middleware-ul aruncă această InvalidOperationException, care conține excepția originală, ca să nu ascundă eroarea reală sub un 404 înșelător. În versiunile anterioare, clientul primea pur și simplu 404 pentru o eroare de server.

Prima întrebare de pus: există un endpoint la calea dată și acceptă toate metodele HTTP? app.Map("/eroare", ...) acceptă orice metodă; app.MapGet doar GET.

De ce apare: cauzele frecvente

1Endpoint-ul de eroare lipsește

Greșit
C#
app.UseExceptionHandler("/eroare");
// nu există nimic la /eroare
Corect
C#
app.UseExceptionHandler("/eroare");
app.Map("/eroare", () => Results.Problem("A apărut o eroare. Încearcă din nou."));

Re-executarea găsește acum un endpoint și răspunde cu ProblemDetails 500.

2Endpoint doar pentru GET, cererea era POST

Greșit
C#
app.MapGet("/eroare", () => Results.Problem());
// POST /comenzi aruncă -> re-executare ca POST /eroare -> 404
Corect
C#
app.Map("/eroare", () => Results.Problem());

Re-executarea păstrează metoda HTTP. Map acceptă toate metodele.

Repară tu

Repară eroarea, direct în pagină

În Production, GET /comenzi/5 aruncă o excepție, iar UseExceptionHandler("/eroare") re-execută cererea la /eroare, unde nu există niciun endpoint, deci clientul primește 404 în loc de 500. Adaugă endpoint-ul /eroare (pentru toate metodele) care întoarce Results.Problem("Comanda nu a putut fi încărcată.").

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

app.MapGet("/comenzi/{id:int}", string (int id) => throw new InvalidOperationException($"Comanda {id} are date corupte"));
// TODO: endpoint-ul /eroare

app.Run();
După reparație, programul afișează
GET /comenzi/5 → 500 Internal Server Error
{"type":"https://tools.ietf.org/html/rfc9110#section-15.6.1","title":"An error occurred while processing your request.","status":500,"detail":"Comanda nu a putut fi încărcată."}
Indiciu

app.Map("/eroare", ...) acceptă orice metodă HTTP.

Alte forme ale mesajului

  • GET /comenzi/5 → 404 Not Found (în loc de 500, în versiunile ASP.NET Core înainte de 8)

Cum o eviți pe viitor

  • Când folosești o cale pentru erori, adaug-o cu app.Map (toate metodele) și testeaz-o cu o excepție intenționată.
  • Varianta modernă, AddProblemDetails() + UseExceptionHandler(), nu are nevoie de endpoint.
  • Nu lăsa endpoint-ul de eroare să arunce el însuși excepții.

Întrebări frecvente

Când are sens AllowStatusCode404Response?

Doar când handler-ul tău întoarce intenționat 404 pentru unele excepții (de exemplu EntitateNegasitaException). Pentru o cale lipsă, nu: ai ascunde eroarea.

De ce în laborator văd doar 404?

Laboratorul re-execută cererea la calea dată și afișează răspunsul obținut, 404, fără excepția suplimentară adăugată în .NET 8. Cauza și repararea sunt aceleași.

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.