.NET怎么使用 Polly 实现服务熔断和重试

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

在 .NET 中使用 Polly 可以很方便地实现服务熔断和重试机制,提升系统的容错能力和稳定性。Polly 是一个强大的弹性处理库,支持重试、熔断、超时、降级等多种策略。

安装 Polly 包

在项目中使用 Polly 前,需要先通过 NuGet 安装相关包:

Install-Package Polly

Install-Package Microsoft.Extensions.Http.Polly

如果你使用的是 ASP.NET Core 并配合 IHttpClientFactory,第二个包可以帮助你在 HttpClient 中集成策略。

配置重试策略

重试策略用于在网络抖动或临时故障时自动重试请求。常见的有:等待固定时间重试、指数退避重试等。

示例:实现指数退避重试(最多重试3次)

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

说明:

Handle:捕获网络异常 OrResult:对非成功状态码也触发重试 WaitAndRetryAsync:每次等待时间递增(2, 4, 8 秒)

配置熔断策略

熔断器可以在服务持续失败时“熔断”,避免雪崩效应。一段时间内失败次数达到阈值后,直接拒绝请求。

示例:连续5次失败后熔断,持续30秒

var circuitBreakerPolicy = Policy .Handle() .OrResult(r => !r.IsSuccessStatusCode) .CircuitBreakerAsync( handledEventsAllowedBeforeBreaking: 5, durationOfBreak: TimeSpan.FromSeconds(30));

说明:

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

组合策略并应用到 HttpClient

可以将多个策略组合成一个“策略包裹”(PolicyWrap),并在发起 HTTP 请求时统一应用。

在 ASP.NET Core 的 Program.cs(或 Startup.cs)中配置:

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

或者使用 Wrap 将多个策略合并:

var policyWrap = Policy.WrapAsync(retryPolicy, circuitBreakerPolicy); services.AddHttpClient("wrapped-client") .AddPolicyHandler(policyWrap);

使用时注入 IHttpClientFactory:

var client = _httpClientFactory.CreateClient("wrapped-client"); var response = await client.GetAsync("https://api.example.com/data");

基本上就这些。合理设置重试与熔断参数,能显著提升服务对外部依赖的容忍度。注意熔断后应配合日志或监控,便于及时发现下游服务问题。

相关推荐