如何排查.NET 6 C#应用中HTTP请求随机超时异常的原因？

一、增强代码日志采集，深挖异常细节 #

默认System.TimeoutException没有足够信息，需要在代码层面补充全链路日志，定位超时发生的具体阶段：

• 记录请求发起时间、目标地址、请求头（敏感字段脱敏），便于后续关联分析
• 自定义DelegatingHandler拦截请求生命周期，打印连接建立、请求发送、响应接收各阶段的耗时，区分是连接阶段超时还是数据传输阶段超时
• 强制捕获并打印异常的InnerException，底层SocketException通常会携带Win32错误码（比如10060对应连接超时、10054对应远程主机重置连接），这是定位网络底层问题的关键

示例代码片段：

public class RequestLoggingHandler : DelegatingHandler
{
    private readonly ILogger<RequestLoggingHandler> _logger;

    public RequestLoggingHandler(ILogger<RequestLoggingHandler> logger)
    {
        _logger = logger;
    }

    protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        var startTime = DateTime.UtcNow;
        _logger.LogInformation("请求启动：{Method} {Uri} | 时间：{Time}", request.Method, request.RequestUri, startTime);
        
        try
        {
            var response = await base.SendAsync(request, cancellationToken);
            var duration = DateTime.UtcNow - startTime;
            _logger.LogInformation("请求完成：{StatusCode} | 耗时：{Duration}ms", (int)response.StatusCode, duration.TotalMilliseconds);
            return response;
        }
        catch (Exception ex)
        {
            var duration = DateTime.UtcNow - startTime;
            var innerEx = ex.InnerException;
            _logger.LogError(ex, "请求失败：{Method} {Uri} | 耗时：{Duration}ms | 内部异常类型：{InnerType} | 内部异常信息：{InnerMsg}", 
                request.Method, request.RequestUri, duration.TotalMilliseconds, innerEx?.GetType().Name, innerEx?.Message);
            throw;
        }
    }
}

// 注入到HttpClient
builder.Services.AddHttpClient("BackendApi")
    .AddHttpMessageHandler<RequestLoggingHandler>();

二、操作系统层面排查 #

因问题仅出现在部分机器，优先排查这些机器的系统配置：

• 查看系统事件日志：打开事件查看器，检查Windows日志->系统中的TCP/IP、网卡驱动报错，以及应用程序日志里的.NET运行时异常
• 检查TCP连接状态：执行netstat -ano命令，查看超时发生时是否有大量TIME_WAIT/CLOSE_WAIT状态的连接，若存在需调整系统TCP参数（比如TcpTimedWaitDelay）释放端口
• 验证防火墙/杀毒软件：临时关闭机器上的防火墙或杀毒软件，测试是否还会出现超时，排除规则随机拦截的可能
• 更新网卡驱动：检查网卡驱动版本，若存在兼容性问题，升级至官方最新稳定版

三、网络链路诊断 #

• 连通性测试：超时期间用ping测试目标主机的丢包率，用tracert（Linux/macOS用traceroute）排查路由节点的延迟或丢包情况
• 抓包分析：用Wireshark（Windows）或tcpdump（Linux）抓取目标地址的HTTP/HTTPS流量，确认是SYN包无响应（连接建立超时）、数据传输无ACK，还是远程主机返回RST包
• DNS解析验证：超时期间用nslookup/dig测试目标域名的解析速度和结果，排除DNS解析延迟或错误的影响

四、远程主机侧验证 #

• 联系目标服务运维团队，确认超时期间服务是否存在负载过高、限流、节点故障等情况，查看服务端日志是否有对应请求的记录（是否收到请求、处理耗时）
• 对比测试：用其他正常机器访问同一目标服务，若仅问题机器出现超时，基本排除远程主机的问题

五、应用自身配置检查 #

• 检查HttpClient实例管理：确保复用HttpClient实例（通过DI注入），避免频繁创建实例导致连接池耗尽
• 核对超时配置：确认HttpClient.Timeout设置合理，但随机超时通常和超时值无关，更多是资源或链路问题
• 控制并发数：检查是否同时发起过多并发请求，导致机器网络资源耗尽

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