抛出HttpResponseException始终返回500错误码的问题排查

你的问题根源在于：你使用的是旧版ASP.NET Web API的API（IHttpActionResult、HttpResponseException），但.NET 6属于ASP.NET Core框架，这两套框架的错误处理机制不兼容。HttpResponseException在ASP.NET Core中已被移除，抛出它会被视为未处理异常，因此客户端始终收到500错误。

以下是几种可行的解决方式：

方式一：使用ASP.NET Core内置的状态码返回方法（推荐） #

ASP.NET Core的ControllerBase提供了一系列内置方法，可直接返回对应HTTP状态码的响应，无需抛出异常。根据你的需求修改代码：

如果只需返回字符串提示：

[HttpGet]
public IActionResult Get()
{
    return NotFound("Could not find..");
}

如果需要返回包含ReasonPhrase的自定义结构：

[HttpGet]
public IActionResult Get()
{
    return NotFound(new 
    { 
        Message = "Could not find..", 
        ReasonPhrase = "Test not found" 
    });
}

如果方法必须返回IEnumerable<T>，可以用ObjectResult指定状态码：

[HttpGet]
public ObjectResult Get()
{
    // 无数据时返回404
    return new ObjectResult(null)
    {
        StatusCode = (int)HttpStatusCode.NotFound,
        Value = new { Message = "Could not find..", ReasonPhrase = "Test not found" }
    };
}

方式二：自定义异常+异常过滤器（适合需用异常处理的场景） #

如果业务逻辑必须通过抛出异常处理错误，可以自定义异常并通过过滤器捕获转换为响应：

1. 定义自定义异常类：

public class HttpStatusException : Exception
{
    public HttpStatusCode StatusCode { get; }

    public HttpStatusException(HttpStatusCode statusCode, string message) : base(message)
    {
        StatusCode = statusCode;
    }
}

2. 创建异常过滤器：

public class HttpStatusExceptionFilter : IExceptionFilter
{
    public void OnException(ExceptionContext context)
    {
        if (context.Exception is HttpStatusException httpException)
        {
            context.Result = new ObjectResult(new
            {
                Message = httpException.Message,
                ReasonPhrase = httpException.Message
            })
            {
                StatusCode = (int)httpException.StatusCode
            };
            context.ExceptionHandled = true;
        }
    }
}

3. 在Program.cs中注册过滤器：

builder.Services.AddControllers(options =>
{
    options.Filters.Add<HttpStatusExceptionFilter>();
});

4. 在控制器中使用：

[HttpGet]
public IEnumerable<YourModel> Get()
{
    throw new HttpStatusException(HttpStatusCode.NotFound, "Could not find..");
}

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