如何返回端点状态码使其可被app.UseStatusCodePages()中间件处理

架构老林

2026-8-28

你对问题根因的判断完全准确：UseStatusCodePages 中间件的触发前提非常严格，只有当响应状态码落在400-599的错误区间、响应体完全没有写入任何内容、响应也未开始发送给客户端时，它才会接管请求生成自定义错误响应。

你遇到的StatusCode(xxx)返回后中间件不生效的问题，本质是两种情况导致的：要么你调用了带第二个参数的StatusCode重载，框架自动把传入的对象序列化写入了响应体；要么是项目开启了ApiController默认的自动ProblemDetails响应生成，框架在返回纯状态码结果时自动补了错误响应内容，两种情况都会让UseStatusCodePages认为响应已经有内容，直接跳过执行。

可行的解决方法

最稳妥的写法：直接给响应对象设置状态码，返回空结果
这种写法完全不会向响应体写入任何内容，全版本ASP.NET Core都能正常触发UseStatusCodePages：

public IActionResult ForbiddenTest()
{
    Response.StatusCode = StatusCodes.Status403Forbidden;
    // 返回空结果，不写入任何响应内容
    return Empty();
}

如果你想继续用StatusCode()方法返回结果
需要先关闭对应控制器/接口的自动错误响应生成，避免框架自动补ProblemDetails内容：

[ApiController]
[Route("api/[controller]")]
// 标注当前控制器不自动生成错误响应内容
[ProducesErrorResponseType(typeof(void))]
public class TestController : ControllerBase
{
    [HttpGet]
    public IActionResult Get()
    {
        // 此时调用单参数的StatusCode方法不会写入响应体，中间件可正常触发
        return StatusCode(StatusCodes.Status403Forbidden);
    }
}