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").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
UseExceptionHandler() prinde excepțiile neprinse și produce un răspuns. Pentru asta are nevoie de una dintre trei configurări:
- o cale (
ExceptionHandlingPath), de exempluUseExceptionHandler("/eroare"), la care cererea e re-executată; - un delegat (
ExceptionHandler), de exempluUseExceptionHandler(ramura => ramura.Run(...)); - serviciul ProblemDetails (
builder.Services.AddProblemDetails()), care generează răspunsul standard.
Versiunea fără argumente, introdusă în .NET 7, funcționează doar în combinație cu AddProblemDetails() (sau cu AddExceptionHandler). Fără niciuna, aplicația se oprește la pornire cu mesajul acesta lung, care chiar îți spune toate variantele de reparare. Mesajul mai pomenește Startup.ConfigureServices din motive istorice; în aplicațiile noi, înregistrarea se face pe builder.Services.
De ce apare: cauzele frecvente
1UseExceptionHandler() fără AddProblemDetails
var app = builder.Build();
app.UseExceptionHandler();builder.Services.AddProblemDetails();
var app = builder.Build();
app.UseExceptionHandler();AddProblemDetails îi dă middleware-ului un mod de a scrie răspunsul (ProblemDetails 500).
2Preferi o pagină / endpoint propriu
app.UseExceptionHandler();app.UseExceptionHandler("/eroare");
app.Map("/eroare", () => Results.Problem("A apărut o eroare. Încearcă din nou."));Cu o cale, cererea care a eșuat e re-executată la endpoint-ul tău de eroare.
Repară eroarea, direct în pagină
Aplicația nu pornește în Production: app.UseExceptionHandler() nu are cum să răspundă la excepții. Înregistrează serviciul ProblemDetails, ca GET /rapoarte/lunar (care aruncă o excepție) să întoarcă ProblemDetails 500, iar GET / să răspundă normal.
var builder = WebApplication.CreateBuilder(args);
// TODO: middleware-ul de excepții are nevoie de un mod de a răspunde
var app = builder.Build();
app.UseExceptionHandler();
app.MapGet("/", () => "Magazin pornit");
app.MapGet("/rapoarte/lunar", string () => throw new InvalidOperationException("Sursa de date nu răspunde"));
app.Run();GET / → 200 OK
Magazin pornit
GET /rapoarte/lunar → 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}Indiciu
Lipsește un singur apel pe builder.Services.
Reparația
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddProblemDetails();
var app = builder.Build();
app.UseExceptionHandler();
app.MapGet("/", () => "Magazin pornit");
app.MapGet("/rapoarte/lunar", string () => throw new InvalidOperationException("Sursa de date nu răspunde"));
app.Run();De ce merge
Varianta fără argumente a lui UseExceptionHandler are nevoie de un generator de răspuns. AddProblemDetails() înregistrează serviciul care scrie răspunsul standard RFC 9110 (application/problem+json, status 500, titlu generic). Pipeline-ul se construiește fără eroare, iar excepția din raport devine un răspuns curat, fără detalii interne.
Cum o eviți pe viitor
- În șablonul tău de proiect, pune împreună
AddProblemDetails()șiUseExceptionHandler(). - Pune
UseExceptionHandlerprimul în pipeline, ca să prindă excepțiile tuturor middleware-urilor de după el. - Rulează local și cu
ASPNETCORE_ENVIRONMENT=Production, ca să vezi comportamentul real de erori. - Când treci de la
UseExceptionHandler("/eroare")la varianta fără argumente, adaugă în același pasAddProblemDetails()sau unIExceptionHandler.
Întrebări frecvente
De ce eroarea apare la pornire, nu la prima excepție?
Middleware-ul își verifică opțiunile când e construit pipeline-ul. Fără nicio metodă de a răspunde, configurarea e invalidă, deci aplicația nu pornește.
Am nevoie de UseExceptionHandler și în Development?
În Development, pagina pentru dezvoltatori e activă implicit și arată excepția. Mulți pun UseExceptionHandler doar pe ramura if (!app.Environment.IsDevelopment()), dar poți să-l ai peste tot ca să testezi răspunsul real.
Erori înrudite
{"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. 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(). An unhandled exception has occurred while executing the request. Codul unui endpoint a aruncat o excepție pe care nu a prins-o nimeni, așa că ASP.NET Core a răspuns 500 Internal Server Error și a scris acest mesaj în log, urmat de excepția reală. Citește excepția de sub mesaj și tratează cazul în handler (de exemplu 404 pentru o resursă lipsă). Î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.
