Flurl超时异常不一致：大超时值抛FlurlHttpException而非FlurlHttpTimeoutException

这个问题的核心是Flurl对不同来源的超时异常处理逻辑不同：当超时由HttpClient.Timeout（请求整体超时）触发时，Flurl会抛出FlurlHttpTimeoutException；但如果超时来自底层TCP连接阶段（比如操作系统层面的连接超时，或HttpClientHandler.ConnectTimeout触发），Flurl会将其包装为通用的FlurlHttpException。你设置的超时阈值≥130秒时，可能触发的是后者的场景，因此抛出了不同的异常类型。

下面是几种可行的解决方案：

方法1：在异常捕获时手动识别并转换超时异常 #

在你的catch (FlurlHttpException)块中，添加逻辑判断当前异常是否属于超时场景，若是则将其转换为FlurlHttpTimeoutException抛出。这种方式无需全局配置，仅针对当前请求处理：

try {
    // 你的Flurl请求代码...
    using (IFlurlClient flurlClient = new FlurlClient(Url)) {
        string response = await flurlClient
            .Configure(s => s.Timeout = TimeSpan.FromSeconds(130))
            .WithOAuthBearerToken(accessToken)
            .Request()
            .PostJsonAsync(result)
            .ReceiveString();
        Logger.LogInformation(response);
        ListenerResponse listenerResponse = JsonConvert.DeserializeObject<ListenerResponse>(response);
        Logger.LogInformation(listenerResponse.Success.ToString());
        if (!listenerResponse.Success) {
            throw new RejectedException("Listener rejected the request.");
        }
    }
} catch (FlurlHttpTimeoutException ex) {
    Logger.LogError(ex, $"Could not reach to Listener at: {Url}.");
    throw;
} catch (FlurlHttpException ex) {
    // 判断是否为超时相关异常
    bool isTimeout = 
        // 检查异常消息是否包含超时关键词
        ex.Message.Contains("timed out") ||
        // 检查内部异常是否是HttpRequestTimeout类型
        (ex.InnerException is HttpRequestException reqEx && reqEx.Message.Contains("timed out")) ||
        // 检查是否是未手动取消的TaskCanceledException（可能是超时导致）
        (ex.InnerException is TaskCanceledException tce && !tce.CancellationToken.IsCancellationRequested);

    if (isTimeout) {
        // 转换为FlurlHttpTimeoutException并抛出
        var timeoutEx = new FlurlHttpTimeoutException(ex.Call, ex.Message, ex);
        Logger.LogError(timeoutEx, $"Could not reach to Listener at: {Url}.");
        throw timeoutEx;
    }

    // 处理非超时的FlurlHttpException
    Logger.LogError(ex, ex.Message);
    throw;
}

方法2：全局配置Flurl异常处理策略 #

如果你希望所有Flurl请求都统一处理超时异常，可以在应用启动时全局配置Flurl的错误处理逻辑，自动将超时相关的FlurlHttpException转换为FlurlHttpTimeoutException：

// 在应用初始化时调用（比如Program.cs或Startup.cs）
FlurlHttp.Configure(settings => {
    settings.OnErrorAsync = call => {
        if (call.Exception is FlurlHttpException flurlEx && IsTimeoutRelated(flurlEx)) {
            // 替换原异常为FlurlHttpTimeoutException
            call.Exception = new FlurlHttpTimeoutException(call, flurlEx.Message, flurlEx);
        }
        return Task.CompletedTask;
    };
});

// 辅助方法：判断是否为超时相关异常
private static bool IsTimeoutRelated(FlurlHttpException ex) {
    if (ex.Message.Contains("timed out")) return true;
    
    var innerEx = ex.InnerException;
    return innerEx is HttpRequestException reqEx && reqEx.Message.Contains("timed out") ||
           innerEx is TaskCanceledException tce && !tce.CancellationToken.IsCancellationRequested;
}

配置完成后，所有符合条件的超时异常都会自动转为FlurlHttpTimeoutException，你原有的catch块无需修改即可捕获。

方法3：精细控制连接超时与请求超时 #

如果你的超时场景区分连接阶段和请求处理阶段，可以通过HttpClientHandler单独设置连接超时，避免底层连接超时触发通用异常。结合方法1或2，能更清晰地控制超时行为：

// 创建自定义HttpClientHandler，设置连接超时
var handler = new HttpClientHandler {
    ConnectTimeout = TimeSpan.FromSeconds(30) // 连接阶段超时30秒
};

using (IFlurlClient flurlClient = new FlurlClient(Url, handler)) {
    string response = await flurlClient
        .Configure(s => s.Timeout = TimeSpan.FromSeconds(130)) // 整体请求超时130秒
        .WithOAuthBearerToken(accessToken)
        .Request()
        .PostJsonAsync(result)
        .ReceiveString();
    // 后续处理逻辑...
    Logger.LogInformation(response);
    ListenerResponse listenerResponse = JsonConvert.DeserializeObject<ListenerResponse>(response);
    Logger.LogInformation(listenerResponse.Success.ToString());
    if (!listenerResponse.Success) {
        throw new RejectedException("Listener rejected the request.");
    }
}

这样，连接超时会在30秒时触发，而整体请求超时在130秒触发，结合异常转换逻辑，所有超时场景都会抛出FlurlHttpTimeoutException。

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