.NET中异步防超时的3种硬核方法与避坑指南

// 重点来了！别让异步请求变成“幽灵线程”——
// 这行是灵魂！没有它，超时就是个摆设
var cts = new CancellationTokenSource(TimeSpan.FromSeconds(10)); // 10秒超时，不是10分钟！
// 为啥不是10分钟？因为用户等不起，产品经理更等不起！

// 模拟一个网络请求（比如调第三方API）
var httpClient = new HttpClient();
try
{
    // 关键：把CancellationToken传进去，这才是“防超时”的核心
    var response = await httpClient.GetStringAsync("https://api.example.com/data", cts.Token); // 传入令牌！
    // 如果超时，这里会抛OperationCanceledException
}
catch (TaskCanceledException ex)
{
    // 你猜怎么着？这异常才是你该处理的！
    // 别直接log，得优雅降级：比如返回缓存或默认值
    LogWarning($"API请求超时：{ex.Message}，已切换到本地缓存");
    return GetLocalFallbackData(); // 优雅降级，别让用户看到500
}
finally
{
    // 一定要释放资源！别让CancellationTokenSource变成内存幽灵
    cts.Dispose(); // 释放，别留垃圾！
}

// 重点来了！别以为HttpClient默认超时是30秒——
// 实际上，它默认是0（永不超时）！
var httpClient = new HttpClient
{
    // 这行是保命符！没它，超时等于没超时
    Timeout = TimeSpan.FromSeconds(10) // 10秒，不是10分钟！
};

// 调用示例
try
{
    var response = await httpClient.GetStringAsync("https://api.example.com/data");
    // 如果超时，这里会抛TaskCanceledException
}
catch (HttpRequestException ex) when (ex.InnerException is TaskCanceledException)
{
    // 别懵！这是超时异常，不是网络故障
    LogError($"第三方API超时：{ex.Message}，已触发熔断机制");
    return HandleTimeoutFallback(); // 触发熔断，别硬扛
}

// 重点来了！别一超时就直接报错——
// 有些超时是网络抖动，重试一次可能就回来了
var retryPolicy = Policy
    .Handle<HttpRequestException>(ex => ex.InnerException is TaskCanceledException)
    .WaitAndRetryAsync(3, retryAttempt => 
        TimeSpan.FromSeconds(Math.Pow(2, retryAttempt))); // 指数退避：2秒、4秒、8秒

// 使用重试策略
try
{
    var result = await retryPolicy.ExecuteAsync(
        () => httpClient.GetStringAsync("https://api.example.com/data"));
    return result;
}
catch (Exception ex)
{
    // 所有重试都失败了，才走这一步
    LogCritical($"API请求彻底失败：{ex.Message}");
    return FallbackToOfflineMode(); // 降级到离线模式
}