如何判断Spring WebClient是否遭遇TCP连接重置或读取超时？

WebClient不会将底层TCP/IP层面的异常转换为HTTP状态码——这类异常属于协议栈底层错误，会直接抛出对应的.NET异常，你可以通过捕获特定异常类型并判断其属性来精准识别：

1. 捕获TCP连接重置异常 #

TCP连接重置对应System.Net.Sockets.SocketException，其ErrorCode属性对应Winsock错误码，连接重置的错误码为10054（WSAECONNRESET）。直接捕获该异常并判断错误码即可：

try
{
    using var client = new WebClient();
    var response = client.DownloadString("https://target-url.com");
}
catch (SocketException ex)
{
    if (ex.ErrorCode == 10054)
    {
        // 处理TCP连接重置场景
        Console.WriteLine("TCP连接被对方重置");
    }
    else
    {
        // 处理其他Socket级异常（如连接拒绝、网络不可达等）
    }
}

2. 捕获读取超时异常 #

WebClient的读取超时会抛出System.Net.WebException，通过检查其Status属性是否为WebExceptionStatus.Timeout即可识别：

注意：.NET Framework中WebClient无直接Timeout属性，需通过继承扩展或改用HttpWebRequest；.NET Core/.NET 5+版本已原生支持WebClient.Timeout。

示例代码（.NET Core/.NET 5+）：

try
{
    using var client = new WebClient();
    client.Timeout = 5000; // 设置5秒超时
    var response = client.DownloadString("https://target-url.com");
}
catch (WebException ex)
{
    if (ex.Status == WebExceptionStatus.Timeout)
    {
        // 处理读取超时场景
        Console.WriteLine("请求读取超时");
    }
    else if (ex.Status == WebExceptionStatus.ConnectFailure)
    {
        // 连接失败类异常，可进一步检查内部异常是否为SocketException
        if (ex.InnerException is SocketException sockEx)
        {
            // 根据sockEx.ErrorCode区分具体连接错误（如10061为连接拒绝）
        }
    }
}

关键提醒 #

HTTP状态码仅适用于HTTP协议层面的响应（如404、500等），TCP连接重置、读取超时属于未建立/中断TCP连接的场景，根本不会触发HTTP响应，因此不可能通过HTTP状态码识别这类问题。

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