.NET怎么使用 Polly 实现服务熔断和重试_Polly熔断重试配置教程

来源:这里教程网 时间:2026-02-21 17:31:50 作者:

在 .NET 项目中使用 Polly 实现服务熔断和重试,是提升系统容错性和稳定性的重要手段。Polly 是一个强大的弹性处理库,支持重试、熔断、超时、降级等多种策略。下面详细介绍如何配置并使用 Polly 的重试与熔断功能。

安装 Polly 包

在开始前,需要通过 NuGet 安装 Polly。推荐使用最新稳定版本:

Install-Package Polly

如果你使用的是 .NET Core 或 .NET 5+,也可以使用依赖注入方式集成 Polly,建议同时安装:

Install-Package Microsoft.Extensions.Http.Polly

配置重试策略

重试策略用于在网络请求失败时自动重新尝试调用服务。常见场景包括网络抖动、临时性超时等。

以下是一个基于 HTTP 请求的重试策略示例,最多重试 3 次,采用指数退避策略:

var retryPolicy = Policy .Handle() .OrResult(r => !r.IsSuccessStatusCode) .WaitAndRetryAsync(3, retryAttempt => TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)));

说明:

Handle:捕获网络异常 OrResult:当响应状态码不是成功时也触发重试 WaitAndRetryAsync:异步重试,间隔时间随次数递增(2s, 4s, 8s)

配置熔断策略

熔断器用于防止系统在服务持续不可用时不断发送请求,造成雪崩效应。当失败次数达到阈值,熔断器打开,后续请求直接失败,直到冷却期结束。

示例如下:

var circuitBreakerPolicy = Policy .Handle() .OrResult(r => !r.IsSuccessStatusCode) .CircuitBreakerAsync( handledEventsAllowedBeforeBreaking: 3, // 连续3次失败后熔断 durationOfBreak: TimeSpan.FromSeconds(10) // 熔断持续10秒 );

说明:

handledEventsAllowedBeforeBreaking:允许失败的次数 durationOfBreak:熔断持续时间,期间请求会直接抛出 BrokenCircuitException

组合多种策略(推荐使用)

实际应用中,通常将重试和熔断策略结合使用,称为“策略包裹(PolicyWrap)”:

var policyWrap = Policy.WrapAsync(circuitBreakerPolicy, retryPolicy);

注意策略顺序:外层是熔断,内层是重试。这样重试过程也会被熔断器监控。

使用策略调用 HTTP 请求:

var httpClient = new HttpClient(); var response = await policyWrap.ExecuteAsync(async () => { return await httpClient.GetAsync("https://api.example.com/data"); });

在 ASP.NET Core 中集成 Polly(使用 IHttpClientFactory)

更推荐在 Startup 或 Program 中通过依赖注入配置:

services.AddHttpClient("resilient-client") .AddPolicyHandler(retryPolicy) .AddPolicyHandler(circuitBreakerPolicy);

或直接使用命名策略:

services.AddHttpClient("demo-client") .AddTransientHttpErrorPolicy(policy => policy.WaitAndRetryAsync(new[] { TimeSpan.FromSeconds(1), TimeSpan.FromSeconds(2), TimeSpan.FromSeconds(3) }));

基本上就这些。合理配置重试和熔断策略,能显著提升服务的健壮性,避免因短暂故障导致整体系统不可用。关键是根据业务场景调整重试次数、间隔和熔断阈值,避免过度重试加重下游压力。

相关推荐