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

System.InvalidOperationException: StatusCode cannot be set because the response has already started.

Pe scurt

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

Greșit
C#
app.MapGet("/rapoarte/{an:int}", async (int an, HttpContext ctx) =>
{
    await ctx.Response.WriteAsync($"Nu există raport pentru {an}");
    ctx.Response.StatusCode = 404;
});
Corect
C#
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

Greșit
C#
app.Use(async (ctx, next) =>
{
    await next(ctx);
    if (inMentenanta) ctx.Response.StatusCode = 503;
});
Corect
C#
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ă tu

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.

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

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 în Response.
  • Când scrii manual: StatusCode, apoi antetele, apoi WriteAsync.
  • Î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

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