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.
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
app.Use(async (ctx, next) =>
{
var start = Stopwatch.GetTimestamp();
await next(ctx);
ctx.Response.Headers["X-Durata"] = Stopwatch.GetElapsedTime(start).TotalMilliseconds + "ms";
});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
await ctx.Response.WriteAsync("id,nume\n1,Laptop");
ctx.Response.ContentType = "text/csv";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ă 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.
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();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.
Reparația
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.Use(async (ctx, next) =>
{
ctx.Response.OnStarting(() =>
{
ctx.Response.Headers["X-Server"] = "magazin-1";
return Task.CompletedTask;
});
await next(ctx);
});
app.MapGet("/produse", () => new[] { "Laptop", "Mouse" });
app.Run();De ce merge
După next, endpoint-ul a scris deja corpul, deci antetele au plecat spre client. Response.OnStarting înregistrează un callback care rulează exact înainte de trimiterea antetelor, indiferent cine scrie primul octet, deci modificarea e permisă. Antetul apare în răspuns, iar middleware-ul nu mai depinde de momentul în care endpoint-ul scrie corpul.
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 înResponse.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
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. 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.
