ASP.NET Core报错：无法设置StatusCode，因为响应已启动

错误原因 #

你遇到的「Status Code cannot be set because the response has already started」错误，核心原因是在控制器尝试返回OK设置状态码时，HTTP响应已经被某个中间件提前启动（比如写入了内容、发送了状态头），导致后续无法修改响应状态码。

结合你提供的代码，大概率是以下两个问题之一：

1. MyShortCircuitMiddleware的逻辑问题：如果这个短路中间件在调用后续中间件（包括控制器）之前，已经向响应写入了内容或设置了状态码，后续控制器返回OK时就会触发错误——因为响应流已经被打开，无法再修改状态码。
2. 异常处理中间件未检查响应状态：当后续中间件已经启动响应后抛出异常，异常处理中间件仍试图修改状态码，也会触发该错误。

具体修复步骤 #

1. 修正MyShortCircuitMiddleware的短路逻辑 #

短路中间件的核心是「满足条件时直接返回响应，不执行后续中间件」，如果你的实现中写入了响应却仍调用_next，请修改为：

public async Task InvokeAsync(HttpContext context)
{
    // 示例：判断是否需要短路
    if (context.Request.Path.StartsWithSegments("/short-circuit"))
    {
        context.Response.StatusCode = StatusCodes.Status200OK;
        await context.Response.WriteAsync("Short circuited response");
        return; // 关键：不调用_next，终止中间件管道
    }

    // 不满足短路条件时，继续执行后续中间件
    await _next(context);
}

确保写入响应后立即返回，不触发后续中间件执行，避免响应流被重复操作。

2. 给异常处理中间件添加响应状态检查 #

在HandleExceptionAsync方法中，先判断响应是否已经启动，避免在无法修改响应时强行操作：

private async Task HandleExceptionAsync(HttpContext context, Exception exception)
{
    // 如果响应已经开始，无法修改，直接记录日志返回
    if (context.Response.HasStarted)
    {
        _logger.LogWarning("[Exp][API] Response already started, cannot handle exception: {Ex}", exception);
        return;
    }

    context.Response.ContentType = "application/json";
    context.Response.StatusCode = (int)HttpStatusCode.InternalServerError;

    var json = JsonSerializer.Serialize(new { 
        title = "Something went wrong!",
        status = (int)HttpStatusCode.InternalServerError,
        errorCode = (int)ErrorCode.ServerFault
    });

    await context.Response.WriteAsync(json);
}

3. 确认中间件顺序正确性 #

当前Program.cs的中间件顺序基本正确，但需注意：

• MyExceptionHandlerMiddleware必须放在最前面，确保能捕获所有后续中间件的异常
• MyShortCircuitMiddleware应放在需要短路的目标中间件之前（比如如果是短路Swagger，就放在UseSwagger之前），但不要影响控制器的正常执行

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