System.InvalidOperationException: StatusCode cannot be set because the response has already started.
Ai schimbat Response.StatusCode după ce ai început să scrii corpul răspunsului; statusul a plecat deja spre client (de obicei 200). Setează codul de status înainte de primul WriteAsync, sau întoarce un rezultat (Results.NotFound()) în loc să scrii manual.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Codul de status e pe prima linie a răspunsului HTTP și pleacă odată cu antetele, la primul octet scris în corp. Dacă scrii întâi corpul (await ctx.Response.WriteAsync(...)) și apoi setezi ctx.Response.StatusCode = 404, statusul real a fost deja trimis (200), iar ASP.NET Core aruncă această excepție.
Apare des în cod care scrie manual răspunsul: un handler care scrie un mesaj și abia apoi decide codul, un middleware care vrea să transforme răspunsul după next, sau un handler de erori care încearcă să seteze 500 după ce o parte din răspuns a plecat (atunci vezi și The response has already started, the error page middleware will not be executed. în log).
Regula e simplă: status, apoi antete, apoi corp. Cel mai sigur e să întorci un IResult (Results.NotFound(...)), care le scrie în ordinea corectă.
De ce apare: cauzele frecvente
1Status setat după corp
app.MapGet("/rapoarte/{an:int}", async (int an, HttpContext ctx) =>
{
await ctx.Response.WriteAsync($"Nu există raport pentru {an}");
ctx.Response.StatusCode = 404;
});app.MapGet("/rapoarte/{an:int}", (int an) =>
Results.NotFound($"Nu există raport pentru {an}"));Results.NotFound setează întâi statusul, apoi scrie corpul.
2Middleware care schimbă statusul după next
app.Use(async (ctx, next) =>
{
await next(ctx);
if (inMentenanta) ctx.Response.StatusCode = 503;
});app.Use(async (ctx, next) =>
{
if (inMentenanta) { ctx.Response.StatusCode = 503; return; }
await next(ctx);
});Decizia se ia înainte ca endpoint-ul să scrie răspunsul: middleware-ul scurtcircuitează pipeline-ul.
Repară eroarea, direct în pagină
GET /rapoarte/2019 trebuie să răspundă 404, dar handler-ul scrie întâi mesajul și abia apoi setează statusul (în ASP.NET Core real: StatusCode cannot be set because the response has already started), așa că clientul primește 200. Rescrie handler-ul cu Results.Ok / Results.NotFound, ca 2025 să dea 200 și 2019 să dea 404 cu mesajul Nu există raport pentru 2019.
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var rapoarte = new Dictionary<int, decimal> { [2024] = 120000m, [2025] = 185000m };
app.MapGet("/rapoarte/{an:int}", async (int an, HttpContext ctx) =>
{
if (rapoarte.TryGetValue(an, out var total))
{
await ctx.Response.WriteAsync($"Vânzări {an}: {total} lei");
return;
}
await ctx.Response.WriteAsync($"Nu există raport pentru {an}");
ctx.Response.StatusCode = 404; // TODO: prea târziu
});
app.Run();GET /rapoarte/2025 → 200 OK "Vânzări 2025: 185000 lei" GET /rapoarte/2019 → 404 Not Found "Nu există raport pentru 2019"
Indiciu
Un IResult scrie statusul înaintea corpului.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var rapoarte = new Dictionary<int, decimal> { [2024] = 120000m, [2025] = 185000m };
app.MapGet("/rapoarte/{an:int}", (int an) =>
rapoarte.TryGetValue(an, out var total)
? Results.Ok($"Vânzări {an}: {total} lei")
: Results.NotFound($"Nu există raport pentru {an}"));
app.Run();De ce merge
Statusul pleacă odată cu primul octet al corpului, deci trebuie decis înainte de scriere. Results.NotFound(mesaj) setează 404 și apoi scrie corpul (ca JSON), iar Results.Ok face la fel cu 200. Handler-ul nu mai lucrează direct cu HttpContext, deci ordinea e mereu corectă.
Alte forme ale mesajului
The response has already started, the error page middleware will not be executed.The response has already started, the error handler will not be executed.
Cum o eviți pe viitor
- Preferă rezultatele (
Results.*,TypedResults.*,ActionResult) scrierii manuale înResponse. - Când scrii manual:
StatusCode, apoi antetele, apoiWriteAsync. - În middleware, ia deciziile despre status înainte de
next. - Verifică
Response.HasStartedîn codul de tratare a erorilor. - Scrie un test care verifică statusul fiecărui caz de eroare, nu doar corpul răspunsului.
Întrebări frecvente
De ce clientul primește 200, deși am setat 404?
Pentru că 200 (valoarea implicită) a plecat odată cu primul octet al corpului. Setarea ulterioară nu mai poate ajunge la client.
Ce înseamnă „the error page middleware will not be executed”?
O excepție a apărut după ce răspunsul pornise. Middleware-ul de erori nu mai poate schimba statusul sau corpul, deci doar loghează excepția, iar clientul primește un răspuns incomplet.
Erori înrudite
System.InvalidOperationException: Headers are read-only, response has already started. Încerci să adaugi un antet după ce primii octeți ai răspunsului au plecat spre client; din acel moment antetele nu mai pot fi schimbate. Setează antetul înainte de a scrie corpul sau, într-un middleware, înregistrează-l cu Response.OnStarting(...), care rulează chiar înainte de trimiterea antetelor. 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.
