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

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()'.

Pe scurt

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 exemplu UseExceptionHandler("/eroare"), la care cererea e re-executată;
  • un delegat (ExceptionHandler), de exemplu UseExceptionHandler(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

Greșit
C#
var app = builder.Build();
app.UseExceptionHandler();
Corect
C#
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

Greșit
C#
app.UseExceptionHandler();
Corect
C#
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ă tu

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.

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

Cum o eviți pe viitor

  • În șablonul tău de proiect, pune împreună AddProblemDetails() și UseExceptionHandler().
  • Pune UseExceptionHandler primul î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 pas AddProblemDetails() sau un IExceptionHandler.

Î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

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