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.
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
app.UseExceptionHandler("/eroare");
// nu există nimic la /eroareapp.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
app.MapGet("/eroare", () => Results.Problem());
// POST /comenzi aruncă -> re-executare ca POST /eroare -> 404app.Map("/eroare", () => Results.Problem());Re-executarea păstrează metoda HTTP. Map acceptă toate metodele.
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ă.").
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();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.
Reparația
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"));
app.Map("/eroare", () => Results.Problem("Comanda nu a putut fi încărcată."));
app.Run();De ce merge
Middleware-ul de excepții nu scrie singur răspunsul când i-ai dat o cale: trimite cererea din nou la acea cale. Cu endpoint-ul /eroare mapat, re-executarea găsește handler-ul, iar Results.Problem produce un ProblemDetails 500. Clientul primește un cod corect, nu un 404 înșelător.
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
System.InvalidOperationException: An error occurred when configuring the exception handler middleware. Either the 'ExceptionHandlingPath' or the 'ExceptionHandler' property must be set in 'UseExceptionHandler()'. Alternatively, set one of the aforementioned properties in 'Startup.ConfigureServices' as follows: 'services.AddExceptionHandler(options => { ... });' or configure to generate a 'ProblemDetails' response in 'service.AddProblemDetails()'. Ai apelat app.UseExceptionHandler() fără argumente, dar middleware-ul nu știe ce să răspundă la o excepție: nu are o cale, nici un delegat și nici AddProblemDetails. Adaugă builder.Services.AddProblemDetails() sau dă o cale: app.UseExceptionHandler("/eroare"). {"type":"https://tools.ietf.org/html/rfc9110#section-15.6.1","title":"An error occurred while processing your request.","status":500} Este răspunsul ProblemDetails generic pe care UseExceptionHandler cu AddProblemDetails îl trimite pentru orice excepție neprinsă. Detaliile sunt doar în log. Dacă excepția corespunde unui caz cunoscut (stoc insuficient, resursă lipsă), mapeaz-o la codul potrivit cu un IExceptionHandler. Î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.
