大网数据广告活动
.NET 与 C# 开发

通过 Polly 实现使用指数退避算法的 HTTP 调用重试

· 52CE 我爱测

建议的使用指数退避算法的重试方法是利用更高级的 .NET 库,如开放源 Polly 库。

建议的使用指数退避算法的重试方法是利用更高级的 .NET 库,如开放源 Polly 库。

Polly 是一个 .NET 库,提供恢复能力和瞬态故障处理功能。 通过应用 Polly 策略(如重试、断路器、舱壁隔离、超时和回退)即可实现这些功能。 Polly 面向 .NET 4.x 和 .NET Standard 库 1.0(支持 .NET Core)。

但是,将包含自定义代码的 Polly 库与 HttpClient 配合使用的过程非常复杂。 eShopOnContainers 的原始版本中包含基于 Polly 的 ResilientHttpClient 构建基块。 但随着 HttpClientFactory 的发布,可复原 HTTP 通信变得更易于实现,因此已弃用 eShopOnContainers 中的构建基块。

以下步骤说明如何通过集成到 HttpClientFactory 中的 Polly(已在上一部分中说明)使用 Http 重试。

引用 ASP.NET Core 2.2 包

自 .NET Core 2.1 起提供 HttpClientFactory,但建议在项目中使用 NuGet 中的最新 ASP.NET Core 2.2 包。 通常需要 AspNetCore 元包和扩展包 Microsoft.Extensions.Http.Polly。

使用 Polly 的重试策略在 Startup 中配置客户端

如前面部分中所示,需要在标准 Startup.ConfigureServices(...) 方法中定义已命名或类型化的客户端 HttpClient 配置,但现在,可使用指数退避算法添加用于指定 Http 重试策略的增量代码,如下所示:

//ConfigureServices()  - Startup.cs
services.AddHttpClient<IBasketService, BasketService>()
        .SetHandlerLifetime(TimeSpan.FromMinutes(5))  //Set lifetime to five minutes
        .AddPolicyHandler(GetRetryPolicy());

将策略添加至将要使用的 HttpClient 对象需要使用 AddPolicyHandler() 方法。 在此示例中,将使用指数退避算法为 Http 重试添加 Polly 策略。

若要获得更加模块化的方法,可在 Startup.cs 文件内的单独方法中定义 Http 重试策略,如以下代码所示:

static IAsyncPolicy<HttpResponseMessage> GetRetryPolicy()
{
    return HttpPolicyExtensions
        .HandleTransientHttpError()
        .OrResult(msg => msg.StatusCode == System.Net.HttpStatusCode.NotFound)
        .WaitAndRetryAsync(6, retryAttempt => TimeSpan.FromSeconds(Math.Pow(2,
                                                                    retryAttempt)));
}

使用 Polly 可定义一个重试策略,其中包含重试次数、指数退避算法配置以及在出现 HTTP 异常时要采取的操作,例如记录错误。 在此示例中,该策略配置为尝试 6 次(采用指数重试),以 2 秒为起始值。

也就是说,它将以 2 秒为起始值尝试 6 次,且每两次重试之间的秒数为指数关系。

将抖动策略添加到重试策略

在高并发率、高可伸缩性和高争用的情况下,常规重试策略可能会对系统产生影响。 在部分运行中断的情况下,有可能会有许多客户端同时发出相似的重试操作,从而形成操作高峰,为克服这种情况,一个好办法是向重试算法或策略中添加抖动策略。 由于增加了指数退避的随机性,这可能会改进端到端系统的整体性能。 这样在出现问题时可以分散峰值。 使用普通 Polly 策略时,用于实现抖动的代码类似下面的示例:

Random jitterer = new Random(); 
Policy
  .Handle<HttpResponseException>() // etc
  .WaitAndRetry(5,    // exponential back-off plus some jitter
      retryAttempt => TimeSpan.FromSeconds(Math.Pow(2, retryAttempt))  
                    + TimeSpan.FromMilliseconds(jitterer.Next(0, 100)) 
  );

其他资源

上一页 下一页

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 01/07/2019
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。