在ActionFilterAttribute中写入响应报错，如何正确终止请求/响应？

在ActionFilterAttribute中使用context.HttpContext.Response.Body.Write或context.HttpContext.Response.WriteAsync时，会触发如下异常：

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.Mvc.Infrastructure.ObjectResultExecutor.ExecuteAsyncCore(ActionContext context, ObjectResult result, Type objectType, Object value)
at Microsoft.AspNetCore.Mvc.Infrastructure.ObjectResultExecutor.ExecuteAsync(ActionContext context, ObjectResult result)
at Microsoft.AspNetCore.Mvc.Infrastructure.ResourceInvoker.ResultNext[TFilter,TFilterAsync](State& next, Scope& scope, Object& state, Boolean& isCompleted)
at Microsoft.AspNetCore.Mvc.Infrastructure.ResourceInvoker.InvokeNextResultFilterAsyncTFilter,TFilterAsync

报错的过滤器示例代码：

[HttpGet, MyFilter]
public ContentResult MyAction()
{
    return new ContentResult() {Content = "test"};
}

public class MyFilter : ActionFilterAttribute
{
    public override void OnActionExecuted(ActionExecutedContext context)
    {
        // 获取上下文的响应对象
        var response = context.HttpContext.Response;

        // 向响应写入数据
        response.ContentType = "text/plain";
        response.WriteAsync("This is some data from the filter!").Wait();
    }
}

需要在过滤器中终止请求/响应，避免后续管道处理引发异常，但尝试Flush、CompleteAsync、赋值context.Result均无效，以下是正确操作方法：

正确终止请求的方法 #

要彻底终止响应管道，需同时完成两步操作：

1. 标记响应流完成：调用context.HttpContext.Response.CompleteAsync()，告知Kestrel服务器响应已结束，禁止后续写入或修改操作。需使用异步调用，避免用.Wait()阻塞线程引发死锁。
2. 短路MVC后续处理：设置context.Result = null，同时标记context.ExceptionHandled = true（无异常场景下），让MVC跳过后续的结果执行逻辑，防止其尝试修改已启动的响应状态码或内容。

修改后的过滤器代码示例：

public class MyFilter : ActionFilterAttribute
{
    public override async Task OnActionExecutedAsync(ActionExecutedContext context, CancellationToken cancellationToken)
    {
        var response = context.HttpContext.Response;
        
        // 先检查响应是否未启动，避免重复操作
        if (!response.HasStarted)
        {
            response.ContentType = "text/plain";
            await response.WriteAsync("This is some data from the filter!", cancellationToken);
        }
        
        // 终止响应流
        await response.CompleteAsync(cancellationToken);
        
        // 短路MVC后续处理流程
        context.Result = null;
        context.ExceptionHandled = true;
    }
}

关键说明 #

• 优先使用异步的OnActionExecutedAsync方法配合await，替代同步方法中的.Wait()，避免线程阻塞和死锁问题。
• CompleteAsync()会直接关闭响应流，阻止任何后续的响应写入或修改操作。
• 设置context.Result = null能让MVC跳过后续的结果执行环节，从根源上避免“尝试修改已启动响应”的异常。

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