ASP.NET Web API抛出HttpRequestException遇HttpStatusCode转换错误

编译错误的核心原因是当前项目使用的.NET Framework版本下的HttpRequestException类，不存在接收HttpStatusCode类型参数的构造函数重载。

• 支持传入HttpStatusCode参数的HttpRequestException构造方法是.NET 5+、.NET Core 3.0+才新增的API，基于传统.NET Framework的ASP.NET Web API 2内置的HttpRequestException仅支持传入字符串类型异常消息、内部异常等参数，没有对应状态码的重载。
• 你查到的传入HttpStatusCode的写法对应高版本ASP.NET Core框架的用法，和当前使用的传统ASP.NET Web API 2版本不兼容，编译器自动匹配最接近的、接收string类型参数的构造重载时，就会抛出“无法将System.Net.HttpStatusCode转换为String”的编译错误。

可根据项目实际情况选择以下任意一种方案修复：

• 方案1：使用Web API原生的HttpResponseException（推荐）
  传统ASP.NET Web API专门提供了HttpResponseException类型用于返回指定HTTP状态码的响应，是该场景下的官方标准写法，修改后代码如下：

public Customers GetCustomer(int id)
{
    var customer = _context.Customers.SingleOrDefault(c => c.Id == id);

    if (customer == null)
        throw new HttpResponseException(HttpStatusCode.NotFound);
    return customer;
}

该写法无需额外配置，异常抛出后框架会自动生成对应状态码的HTTP响应返回给客户端，你写的HttpStatusCode.BadRequest场景也可以直接替换使用。

• 方案2：配合全局异常过滤器使用HttpRequestException
  如果项目统一约定用HttpRequestException处理接口异常，可以在抛出时传入字符串类型的错误消息，再通过全局异常过滤器捕获该类型异常，统一映射为对应HTTP状态码返回：

// 抛出异常时传入自定义错误消息
if (customer == null)
    throw new HttpRequestException("查询的客户资源不存在");

后续在全局异常处理逻辑中，根据异常场景约定设置响应状态码为404、400等即可。

• 方案3：框架升级
  如果项目允许架构调整，迁移到ASP.NET Core框架后，HttpRequestException原生支持传入HttpStatusCode参数的写法，可直接兼容你最初的代码写法。

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