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

System.InvalidOperationException: Headers are read-only, response has already started.

Pe scurt

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

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un răspuns HTTP începe cu linia de status și antetele, urmate de corp. Când codul scrie primul octet al corpului (WriteAsync, WriteAsJsonAsync, rezultatul unui endpoint), ASP.NET Core trimite întâi statusul și antetele. După aceea Response.HasStarted devine true, iar colecția de antete devine read-only.

Greșeala clasică apare într-un middleware care vrea să adauge un antet după await next(context), de exemplu durata cererii (X-Durata): până atunci endpoint-ul a scris deja răspunsul. Apare și când scrii corpul și abia apoi setezi Content-Type sau un cookie.

Soluțiile: setează antetele înainte de next (când valoarea e cunoscută), sau folosește context.Response.OnStarting(callback), care e apelat exact înainte de trimiterea antetelor, când ai și valoarea finală. Poți verifica Response.HasStarted înainte să modifici ceva.

De ce apare: cauzele frecvente

1Antet adăugat după next

Greșit
C#
app.Use(async (ctx, next) =>
{
    var start = Stopwatch.GetTimestamp();
    await next(ctx);
    ctx.Response.Headers["X-Durata"] = Stopwatch.GetElapsedTime(start).TotalMilliseconds + "ms";
});
Corect
C#
app.Use(async (ctx, next) =>
{
    var start = Stopwatch.GetTimestamp();
    ctx.Response.OnStarting(() =>
    {
        ctx.Response.Headers["X-Durata"] = Stopwatch.GetElapsedTime(start).TotalMilliseconds + "ms";
        return Task.CompletedTask;
    });
    await next(ctx);
});

Callback-ul OnStarting rulează înainte ca antetele să plece, deci modificarea e permisă.

2Content-Type setat după scrierea corpului

Greșit
C#
await ctx.Response.WriteAsync("id,nume\n1,Laptop");
ctx.Response.ContentType = "text/csv";
Corect
C#
ctx.Response.ContentType = "text/csv";
await ctx.Response.WriteAsync("id,nume\n1,Laptop");

Antetele (inclusiv Content-Type) se setează înainte de primul octet din corp.

Repară tu

Repară eroarea, direct în pagină

Middleware-ul de audit adaugă antetul X-Server cu valoarea magazin-1 după await next(ctx), când răspunsul a pornit deja (în ASP.NET Core real: Headers are read-only, response has already started). Mută adăugarea în ctx.Response.OnStarting(...), ca antetul să apară la GET /produse.

Codul care dă eroarea
C#
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Use(async (ctx, next) =>
{
    await next(ctx);
    // TODO: prea târziu: răspunsul a pornit deja
    ctx.Response.Headers["X-Server"] = "magazin-1";
});

app.MapGet("/produse", () => new[] { "Laptop", "Mouse" });

app.Run();
După reparație, programul afișează
GET /produse → 200 OK
X-Server: magazin-1
["Laptop","Mouse"]
Indiciu

OnStarting primește o funcție care întoarce Task și e chemată chiar înainte de trimiterea antetelor.

Alte forme ale mesajului

  • System.InvalidOperationException: Headers are read-only, response has already started. at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.HttpHeaders.ThrowHeadersReadOnlyException()

Cum o eviți pe viitor

  • În middleware, setează antetele înainte de await next(context) sau în Response.OnStarting.
  • Când scrii manual răspunsul, ordinea e: status, antete, corp.
  • Verifică context.Response.HasStarted înainte să modifici răspunsul într-un handler de erori.
  • Când un middleware are nevoie de o valoare calculată la final (durată, număr de interogări), scrie-o în log sau în metrici, nu într-un antet adăugat după next.

Întrebări frecvente

De ce eroarea nu apare la răspunsuri mici?

Uneori corpul stă într-un buffer și nu e trimis imediat, deci modificarea trece. Cu răspunsuri mai mari sau cu flush, antetele pleacă devreme și apare eroarea. Codul e greșit în ambele cazuri; folosește OnStarting.

Pot schimba antetele în OnCompleted?

Nu. OnCompleted rulează după ce răspunsul a fost trimis complet; e potrivit pentru loguri și curățenie, nu pentru modificări.

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.