WebApiClientCore中HttpRequestException.StatusCode的处理机制解析

在使用WebApiClientCore 2.0.4版本进行HTTP请求时，开发者可能会遇到一个特殊现象：当服务器返回403 Forbidden状态码时，捕获到的HttpRequestException的StatusCode属性并未如预期般设置为HttpStatusCode.Forbidden。这种现象背后涉及到.NET版本兼容性和异常处理机制的设计考量。

异常处理机制分析

WebApiClientCore作为面向netstandard2.1的库，在异常处理上采用了分层设计。当HTTP请求失败时，框架会创建一个ApiResponseStatusException作为内部异常(InnerException)，而外层则包装为HttpRequestException。这种设计确保了异常信息的丰富性，同时保持了与标准HTTP异常处理模式的一致性。

状态码获取的正确方式

对于需要获取精确HTTP状态码的场景，开发者应当通过检查InnerException来获取详细信息。具体实现如下：

try
{
    // 发起HTTP请求
}
catch (HttpRequestException httpEx)
{
    if (httpEx.InnerException is ApiResponseStatusException apiEx)
    {
        var statusCode = apiEx.StatusCode; // 这里可以获取到实际的403状态码
        // 根据状态码进行相应处理
    }
}

.NET版本兼容性考虑

值得注意的是，HttpRequestException.StatusCode属性是在.NET 5中首次引入的。由于WebApiClientCore 2.0.4版本主要面向netstandard2.1构建，因此没有直接设置该属性值。这是框架为了保持广泛兼容性而做出的设计决策。

最佳实践建议

1. 对于需要精确处理HTTP状态码的场景，建议始终通过检查InnerException来获取状态信息
2. 如果项目环境允许升级，可以考虑使用支持.NET 5+的WebApiClientCore版本，其中已增加了对StatusCode属性的适配
3. 在异常处理逻辑中，应当同时考虑外层异常和内层异常，以确保处理逻辑的健壮性

理解这种异常处理机制的设计原理，有助于开发者编写更可靠的HTTP客户端代码，特别是在需要根据不同HTTP状态码执行不同业务逻辑的场景下。