ASP.NET Core中WriteAsync写入纯文本触发异常的问题咨询

问题代码 #

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Use(async (HttpContext context, RequestDelegate next) =>
{
    await context.Response.WriteAsync("Hello");
    await next(context);
});

app.Use(async (HttpContext context, RequestDelegate next) =>
{
    await context.Response.WriteAsync("Hello again");
    await next(context);
});

app.Run();

触发的错误信息 #

fail: Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware[1]
      An unhandled exception has occurred while executing the request.
      System.InvalidOperationException: StatusCode cannot be set because the response has already started.
         at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.HttpProtocol.ThrowResponseAlreadyStartedException(String value)
         at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.HttpProtocol.set_StatusCode(Int32 value)
         at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.HttpProtocol.Microsoft.AspNetCore.Http.Features.IHttpResponseFeature.set_StatusCode(Int32 value)
         at Microsoft.AspNetCore.Http.DefaultHttpResponse.set_StatusCode(Int32 value)
         at Microsoft.AspNetCore.Builder.ApplicationBuilder.<>c.<Build>b__18_0(HttpContext context)
         at Program.<>c.<<<Main>$>b__0_1>d.MoveNext() in C:\aspnetApps\WebApplication_test\WebApplication_test\Program.cs:line 13
      --- End of stack trace from previous location ---
         at Program.<>c.<<<Main>$>b__0_0>d.MoveNext() in C:\aspnetApps\WebApplication_test\WebApplication_test\Program.cs:line 7
      --- End of stack trace from previous location ---
         at Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware.Invoke(HttpContext context)
warn: Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware[2]
      The response has already started, the error page middleware will not be executed.
fail: Microsoft.AspNetCore.Server.Kestrel[13]
      Connection id "0HMN0TEI6NPN9", Request id "0HMN0TEI6NPN9:00000002": An unhandled exception was thrown by the application.
      System.InvalidOperationException: StatusCode cannot be set because the response has already started.
         at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.HttpProtocol.ThrowResponseAlreadyStartedException(String value)
         at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.HttpProtocol.set_StatusCode(Int32 value)
         at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.HttpProtocol.Microsoft.AspNetCore.Http.Features.IHttpResponseFeature.set_StatusCode(Int32 value)
         at Microsoft.AspNetCore.Http.DefaultHttpResponse.set_StatusCode(Int32 value)
         at Microsoft.AspNetCore.Builder.ApplicationBuilder.<>c.<Build>b__18_0(HttpContext context)
         at Program.<>c.<<<Main>$>b__0_1>d.MoveNext() in C:\aspnetApps\WebApplication_test\WebApplication_test\Program.cs:line 13
      --- End of stack trace from previous location ---
         at Program.<>c.<<<Main>$>b__0_0>d.MoveNext() in C:\aspnetApps\WebApplication_test\WebApplication_test\Program.cs:line 7
      --- End of stack trace from previous location ---
         at Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware.Invoke(HttpContext context)
         at Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware.Invoke(HttpContext context)
         at Microsoft.WebTools.BrowserLink.Net.BrowserLinkMiddleware.ExecuteWithFilterAsync(IHttpSocketAdapter injectScriptSocket, String requestId, HttpContext httpContext)
         at Microsoft.AspNetCore.Watch.BrowserRefresh.BrowserRefreshMiddleware.InvokeAsync(HttpContext context)
         at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.HttpProtocol.ProcessRequests[TContext](IHttpApplication`1 application)

观察到的现象 #

• 给输出内容添加HTML标签（如await context.Response.WriteAsync("<p>Hello</p>");）时，程序可正常运行
• 手动设置Content-Type = "text/plain"后，仍会触发相同错误：

app.Use(async (HttpContext context, RequestDelegate next) =>
{
    context.Response.ContentType = "text/plain";
    await context.Response.WriteAsync("Hello");
    await next(context);
});

原因分析 #

错误核心是：调用WriteAsync输出内容后，响应的头部和部分内容已发送至客户端，此时后续中间件尝试修改响应状态码会触发异常。

添加HTML标签时不报错的原因是：ASP.NET Core检测到输出为HTML时，会自动完成响应收尾，后续中间件不会再尝试修改状态码；而纯文本输出时，app.Run()内部的默认逻辑会尝试设置状态码，但此时响应已启动，导致冲突。仅设置Content-Type无法解决问题，因为关键是你调用了next(context)让后续中间件继续执行，而它们会尝试修改已启动的响应。

解决方案 #

方案1：输出后终止中间件管道（推荐） #

输出纯文本后不再调用next(context)，终止管道执行，避免后续中间件修改响应：

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Use(async (HttpContext context, RequestDelegate next) =>
{
    context.Response.ContentType = "text/plain";
    await context.Response.WriteAsync("Hello");
    // 不调用next，终止管道
});

// 此中间件不会被执行，可根据需求调整
app.Use(async (HttpContext context, RequestDelegate next) =>
{
    await context.Response.WriteAsync("Hello again");
    await next(context);
});

app.Run();

方案2：使用Run终结中间件 #

如果纯文本响应是最终输出，直接用app.Run替代app.Use，Run本身是终结中间件，不会调用后续管道：

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Run(async (HttpContext context) =>
{
    context.Response.ContentType = "text/plain";
    await context.Response.WriteAsync("Hello");
});

方案3：确保后续中间件不修改响应 #

若必须调用next(context)，需保证所有后续中间件都不会修改响应状态码或头部，但这种方式不可控，不推荐使用。

内容的提问来源于stack exchange，提问作者Fatman54