WebApiClientCore中HttpRequestException.StatusCode的注意事项

在.NET生态系统中，WebApiClientCore是一个广泛使用的HTTP客户端库，它为开发者提供了便捷的API调用方式。然而，在使用过程中，开发者可能会遇到一个关于HttpRequestException.StatusCode属性的特殊行为，这值得深入探讨。

问题现象

当使用WebApiClientCore 2.0.4版本时，如果服务器返回403(Forbidden)状态码，开发者期望通过捕获HttpRequestException并检查其StatusCode属性来获取这个状态码。然而实际上，StatusCode属性并未被正确设置为预期的HttpStatusCode.Forbidden值。

技术背景

HttpRequestException是.NET中处理HTTP请求异常的基础异常类。在.NET 5及更高版本中，Microsoft为HttpRequestException添加了StatusCode属性，这使得开发者能够直接从异常中获取HTTP状态码。

然而，WebApiClientCore 2.0.4版本仅面向netstandard2.1打包，这意味着它需要保持与多种.NET实现和版本的兼容性。由于StatusCode属性是在.NET 5中引入的，因此在netstandard2.1目标框架下，这个属性不会被自动填充。

解决方案

在WebApiClientCore中，当发生HTTP错误时，实际的响应状态码信息被封装在异常的InnerException中。具体来说，InnerException是ApiResponseStatusException类型，开发者可以通过以下方式获取正确的状态码：

try
{
    // 调用API的代码
}
catch (HttpRequestException httpE)
{
    if (httpE.InnerException is WebApiClientCore.Exceptions.ApiResponseStatusException apiEx)
    {
        var statusCode = apiEx.StatusCode;
        // 处理特定状态码
    }
}

最新进展

WebApiClientCore项目已经注意到这个问题，并在后续版本中增加了对.NET 5及更高版本的适配。这意味着在新版本中，HttpRequestException的StatusCode属性将会被正确填充，为开发者提供更一致的异常处理体验。

最佳实践

对于使用WebApiClientCore的开发者，建议：

1. 如果项目目标是.NET 5或更高版本，考虑升级到支持StatusCode属性的WebApiClientCore版本
2. 在netstandard2.1目标下，始终通过检查InnerException来获取详细的错误信息
3. 在异常处理代码中，同时考虑直接异常属性和InnerException中的信息，以确保兼容性

理解这些细节有助于开发者编写更健壮的HTTP客户端代码，特别是在处理各种HTTP错误场景时。