如何合理配置HttpClient重试策略与超时策略的参数？

一、重试、单次超时与退避间隔的关联逻辑 #

当配置重试策略时，必须确保所有重试请求的总耗时不超过系统允许的整体超时上限（你的场景是100秒），否则会出现总耗时超限报错。核心关联公式如下：

总最大耗时 = (重试次数 + 1) × 单次请求超时 + 所有退避间隔的总和

其中：

• (重试次数+1)：包含第一次原始请求和后续所有重试请求的总次数
• 退避间隔总和：指数退避场景下，就是 sleep^1 + sleep^2 + ... + sleep^retryCount 的累加值

推荐关联方案 #

1. 先定单次请求超时：根据依赖服务的实际响应能力设置，比如如果服务95%的请求能在20秒内完成，单次超时设为25-30秒（留足冗余）
2. 再定重试次数：一般2-3次足够，超过5次的重试对成功率提升有限，反而会大幅增加总耗时和系统负载
3. 最后反推退避间隔（sleep）：用整体超时上限减去「(重试次数+1)×单次超时」的剩余时间，分配给退避间隔总和，再选择1.2-2之间的指数基数

二、退避机制的工作原理 #

退避机制是重试前等待一段时间的策略，核心目的是避免大量请求同时重试导致依赖服务雪崩，最常用的是指数退避：

• 初始退避间隔由sleep参数定义
• 第N次重试的等待时间为 sleep^N（比如sleep=1.5时，第1次重试等1.5秒，第2次等2.25秒，第3次等3.375秒）
• 指数增长的逻辑：重试次数越多，说明依赖服务可能越繁忙，更长的等待时间能降低服务的并发压力
• 可选优化：加入抖动（Jitter），在退避时间基础上随机增减小范围数值，避免多个客户端同时触发重试造成的流量峰值

三、针对100秒默认超时的优化配置建议 #

结合你的场景，给出具体配置参考：

• 单次请求超时：设为20秒（既给服务足够响应时间，又避免单次超时占用过多总时长）
• 重试次数：设为3次（平衡成功率和总耗时）
• 退避间隔基数（sleep）：设为1.5，此时退避间隔总和为1.5+2.25+3.375=7.125秒
• 总耗时计算：(3+1)×20 +7.125=87.125秒，远低于100秒的整体超时上限

优化后的代码示例 #

using Polly;
using Polly.Timeout;

// 定义单次请求超时策略（20秒）
var perRequestTimeout = Policy.TimeoutAsync<HttpResponseMessage>(TimeSpan.FromSeconds(20));

// 定义重试策略
var retryPolicy = HttpPolicyExtensions.HandleTransientHttpError()
    .OrResult(msg => msg.StatusCode == System.Net.HttpStatusCode.BadGateway)
    .OrResult(msg => msg.StatusCode == System.Net.HttpStatusCode.RequestTimeout)
    .Or<TimeoutRejectedException>()
    .WaitAndRetryAsync(3, retryAttempt => TimeSpan.FromSeconds(Math.Pow(1.5, retryAttempt)));

// 定义整体超时策略（100秒）
var overallTimeout = Policy.TimeoutAsync<HttpResponseMessage>(TimeSpan.FromSeconds(100));

// 组合策略：外层控制总耗时，内层处理重试和单次请求超时
services.AddHttpClient<Authentication>()
    .AddPolicyHandler(Policy.WrapAsync(overallTimeout, Policy.WrapAsync(retryPolicy, perRequestTimeout)));

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