抛出带指定状态码的HttpRequestException为何始终返回500状态码

问题根因 #

• ASP.NET Core 内置的异常处理管线默认不会解析 HttpRequestException 中携带的状态码字段，所有未被显式捕获的服务端异常，都会被默认归为服务器内部错误，统一返回500状态码。
• 你抛出的 HttpRequestException 本质属于普通异常类，框架没有内置针对该类型的特殊转换逻辑，自然不会将你传入的 MethodNotAllowed（405）映射到响应状态码上。

常见解决方案 #

方案1：返回ProblemDetails（推荐，符合REST规范） #

不要直接抛出异常，直接在操作方法中指定状态码和响应内容即可，代码示例：

return Problem(
    detail: "Here's the exception.",
    instance: HttpContext.Request.Path,
    statusCode: (int)HttpStatusCode.MethodNotAllowed,
    title: "Method Not Allowed"
);

方案2：自定义全局异常中间件捕获处理 #

如果你需要保留抛出异常的实现逻辑，可以自行实现全局异常中间件，识别 HttpRequestException 类型后手动提取其状态码属性赋值到HTTP响应中，核心逻辑示例：

app.Use(async (context, next) =>
{
    try
    {
        await next();
    }
    catch (HttpRequestException ex)
    {
        if (ex.StatusCode.HasValue)
        {
            context.Response.StatusCode = (int)ex.StatusCode.Value;
        }
        await context.Response.WriteAsync(ex.Message);
    }
});

方案3：直接操作响应对象 #

不需要抛出异常，直接给当前上下文的响应对象赋值状态码后返回：

HttpContext.Response.StatusCode = (int)HttpStatusCode.MethodNotAllowed;
return Content("Here's the exception.");

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