★ FEATURED ARTICLE 文档教程知识库【免费下载链接】developer-roadmapInteractive roadmaps, guides and other educational content to help developers grow in their careers.项目地址https://gitcode.com/GitHub_Trending/de/developer-roadmap点击查看免费下载Polly 是 .NET 生态中最常用的弹性Resilience与瞬态故障处理库为 ASP.NET Core 应用提供声明式、线程安全的故障应对策略。本文以仓库中 Polly 学习节点 为核心骨架完整讲解 Retry、Circuit Breaker、Timeout、Bulkhead Isolation、Fallback 五大策略的落地写法并演示如何在 ASP.NET Core 的HttpClientFactory中集成帮助你在微服务与外部服务通信场景下构建稳定、优雅降级的系统。什么是 Polly为瞬态故障而生的弹性库在分布式系统中外部服务数据库、消息队列、第三方 API、下游微服务并非永远可用网络抖动、限流、超时、短暂停机都是常态这类很快自己恢复的故障被称为瞬态故障Transient Fault。如果不加处理一次下游抖动可能引发请求堆积、线程饥饿甚至雪崩式故障扩散。Polly 的核心定位就是解决这一问题。正如原文档所定义的Polly 是一个 .NET 弹性和瞬态故障处理库允许开发者以流式fluent且线程安全的方式表达 Retry重试、Circuit Breaker熔断、Timeout超时、Bulkhead Isolation舱壁隔离和 Fallback降级等策略。它定义了当网络请求失败或系统资源失去响应时应用应当如何反应从而在远程服务通信中保持稳定性、优雅处理失败。把 Polly 接入 ASP.NET Core 应用后你的服务调用链会获得三个关键能力可预期每次失败都走既定策略而不是靠运气可控制用熔断和舱壁把故障限制在局部阻止级联扩散可恢复重试、超时、降级让系统在部分依赖不可用时仍能对外提供服务。在 ASP.NET Core 的微服务场景见 Microservices 节点中Polly 常被部署在每个服务的出站 HTTP 调用链上与 REST/gRPC 客户端配合使用。五大核心策略定义、适用场景与代码写法Polly 的策略 API 遵循统一的 fluent 构建模式先通过Policy.HandleT()或HandleResultT()指定要应对的故障再调用策略方法声明应对动作。下面逐一展开。Retry重试瞬态故障重试是最直观的策略当请求因瞬态原因失败时按预设次数与间隔再次尝试。适合网络抖动、数据库瞬时锁冲突、服务短暂不可用等场景。using Polly; // 对 HttpRequestException 重试 3 次每次间隔 2 秒 var retryPolicy Policy .HandleHttpRequestException() .WaitAndRetry(3, retryAttempt TimeSpan.FromSeconds(2));WaitAndRetry 的延时参数可以是一个函数由此可以实现指数退避Exponential Backoff避免重试风暴var retryWithBackoff Policy .HandleHttpRequestException() .WaitAndRetry(5, attempt TimeSpan.FromSeconds(Math.Pow(2, attempt)), onRetry: (exception, timeSpan, retryCount, context) { // 记录重试信息便于可观测性分析 Console.WriteLine($第 {retryCount} 次重试等待 {timeSpan}异常{exception.Message}); });要点HandleTException()精确匹配异常类型HandleTException(ex ex.Message.Contains(timeout))可按条件筛选HandleResultTResult(r r.StatusCode HttpStatusCode.TooManyRequests)可对非异常的失败响应如 429、503触发重试重试次数不宜过大需与下游服务限流策略配合否则会放大系统负载。Circuit Breaker熔断阻止故障扩散重试解决单次失败但若下游持续故障无休止的重试只会加剧资源消耗。熔断器采用三态模型Closed关闭请求正常放行同时统计失败次数Open打开失败次数达到阈值后熔断打开在durationOfBreak内直接快速失败不再发起真实请求给下游喘息恢复的时间Half-Open半开熔断到期后放行少量探测请求若成功则恢复 Closed若失败则重新进入 Open。var circuitBreakerPolicy Policy .HandleHttpRequestException() .CircuitBreaker( handledEventsAllowedBeforeBreaking: 5, // 连续失败 5 次触发熔断 durationOfBreak: TimeSpan.FromSeconds(30), // 熔断持续 30 秒 onBreak: (ex, breakDelay) Console.WriteLine($熔断开启 {breakDelay}原因{ex.Message}), onReset: () Console.WriteLine(熔断关闭服务恢复), onHalfOpen: () Console.WriteLine(进入半开状态放行探测请求));在云原生语境下熔断是典型的可靠性模式之一仓库 Reliability Patterns 将 Circuit Breaker 与 Failover、Retry、Bulkhead 等并列为核心可靠性手段而 Steeltoe 节点 也把 circuit breaking 列为 .NET 云原生应用的关键能力。Polly 则是这一模式在 .NET 中最直接的实现载体。Timeout超时兜底即使下游看起来活着一个迟迟不返回的请求也会长期占用连接和线程。Timeout 策略为整个策略执行过程设定总时间上限防止请求无限期挂起。var timeoutPolicy Policy .Timeout(TimeSpan.FromSeconds(10), TimeoutStrategy.Optimistic);TimeoutStrategy.Optimistic不主动取消操作依赖取消令牌CancellationToken协作适合支持取消的调用TimeoutStrategy.Pessimistic在超时点强制终止操作可能抛出TimeoutRejectedException适合无法协作取消的同步调用。实践中应把 Timeout 放在策略组合的最外层作为全局兜底。Bulkhead Isolation舱壁隔离保护自身资源Bulkhead舱壁源自造船业——船体被分隔成独立隔舱单个舱进水不会导致整船沉没。映射到软件为调用下游的关键操作分配独立的并发槽位与队列当某个下游变慢占满槽位时其他下游调用不受影响防止线程池被单一故障依赖耗尽。var bulkheadPolicy Policy.Bulkhead( maxParallelization: 12, // 最大并发执行数 maxQueuingActions: 4); // 排队等待的最大请求数超出则快速失败对于有依赖的异步场景使用Policy.BulkheadAsync(maxParallelization, maxQueuingActions)并配合ExecuteAsync。这是微服务架构中防止一个慢依赖拖垮整个服务的核心手段。Fallback降级兜底当重试耗尽、熔断打开、超时触发后应用不能就此抛错——Fallback 策略提供一个备选结果让用户请求仍能获得响应var fallbackPolicy Policystring .HandleException() .Fallback(服务暂时不可用请稍后重试); // 返回兜底数据 var result fallbackPolicy.Execute(() CallDownstreamService());Fallback 可以是固定值、缓存数据与 Caching 节点 结合实现缓存兜底、或降级服务的调用。它是优雅降级的最后一环保证故障时用户体验不中断。ASP.NET Core 集成HttpClientFactory 与策略注册在实际 ASP.NET Core 项目中最常用的集成方式是配合HttpClientFactory——它为每个命名/类型化 HttpClient 维护一个HttpClientHandler管道允许通过AddPolicyHandler把 Polly 策略注入请求执行链。这种写法让策略与业务代码解耦只需在Program.cs中集中声明。using Polly; using Polly.Extensions.Http; builder.Services.AddHttpClient(payment) .AddPolicyHandler(Policy .HandleHttpRequestException() .OrResultHttpResponseMessage(r r.StatusCode System.Net.HttpStatusCode.TooManyRequests) .WaitAndRetryAsync(3, attempt TimeSpan.FromSeconds(Math.Pow(2, attempt)))) .AddPolicyHandler(Policy .HandleHttpRequestException() .CircuitBreakerAsync(5, TimeSpan.FromSeconds(30))) .AddPolicyHandler(Policy.TimeoutAsyncHttpResponseMessage(TimeSpan.FromSeconds(10)));要点AddPolicyHandler是Microsoft.Extensions.Http.Polly提供的扩展方法需通过 NuGet 安装该包多个策略会按注册顺序依次包裹执行形成策略管道也可以使用AddPolicyHandler(IServiceProvider, HttpRequestMessage)重载从 DI 容器读取配置动态构建策略。基于配置的策略管理将策略参数下沉到appsettings.json可以做到不重新编译即可调整弹性参数// appsettings.json { Resilience: { RetryCount: 3, RetryBaseDelaySeconds: 2, CircuitBreakerFailureThreshold: 5, CircuitBreakerBreakSeconds: 30, TimeoutSeconds: 10, BulkheadMaxParallelization: 12, BulkheadMaxQueuing: 4 } }var resilience builder.Configuration.GetSection(Resilience); builder.Services.AddHttpClient(order) .AddPolicyHandler(Policy .HandleHttpRequestException() .WaitAndRetryAsync( resilience.GetValueint(RetryCount), attempt TimeSpan.FromSeconds(resilience.GetValuedouble(RetryBaseDelaySeconds))));这种配置驱动策略的方式适合生产环境熔断阈值、超时时间等参数可按流量水位随时调整而无需发布新版本。策略组合与执行上下文单一策略往往不足以应对真实故障链Polly 通过Policy.Wrap/Policy.WrapAsync将多个策略组合为一条完整的保护链。推荐的组合顺序是Fallback最外层→ Bulkhead → Timeout → Circuit Breaker → Retry最内层即先兜底、再隔离、再限时、再熔断、最后重试var strategy Policy.Wrap( fallbackPolicy, // 1. 全局兜底 bulkheadPolicy, // 2. 舱壁隔离 timeoutPolicy, // 3. 超时控制 circuitBreakerPolicy, // 4. 熔断保护 retryPolicy); // 5. 重试瞬态故障 var result await strategy.ExecuteAsync( () client.GetAsync(api/orders), cancellationToken);Polly 还通过Context把调用方元数据如用户 ID、请求 ID传递给策略回调onRetry、onBreak 等配合结构化日志与追踪可参考仓库 Serilog 节点即可实现哪个业务、哪次调用、触发了哪种策略的完整可观测性。关键设计与落地建议识别瞬态与持久故障重试只应面向瞬态故障对 404、400 等业务性错误使用HandleResult精确过滤避免无效重试。重试必须配合退避固定间隔的重试在故障高峰期会形成请求洪峰优先使用指数退避并加入抖动Jitter。熔断阈值按流量校准handledEventsAllowedBeforeBreaking的取值需结合服务 QPS 评估避免正常波动就误熔断或真故障迟迟不熔断。舱壁槽位与线程池匹配maxParallelization应小于依赖服务可承受的并发上限并考虑与 HttpClient 的连接数限制联动。超时与取消令牌协同ASP.NET Core 请求取消时应通过CancellationToken传递给ExecuteAsync让策略尽早感知调用方放弃释放资源。策略参数可配置化将重试次数、熔断时长、超时秒数放入配置中心是生产环境的基本要求。小结Polly 把如何处理失败从散落的 try-catch 中抽象为可组合、可测试、线程安全的策略体系。围绕 Polly 学习节点 中定义的五大策略——Retry、Circuit Breaker、Timeout、Bulkhead Isolation、Fallback——结合HttpClientFactory的策略管道、配置驱动的参数管理以及Policy.Wrap组合机制你可以在 ASP.NET Core 中系统性地构建弹性调用链让重试消化抖动、熔断阻止扩散、超时防止挂死、舱壁保护自身资源、降级保障用户体验。这套能力与仓库中 Steeltoe 的云原生视角、Reliability Patterns 的模式理论互为印证是 .NET 后端工程师构建高可用服务绕不开的核心工具。赞分享文档教程知识库【免费下载链接】developer-roadmapInteractive roadmaps, guides and other educational content to help developers grow in their careers.项目地址https://gitcode.com/GitHub_Trending/de/developer-roadmap点击查看免费下载相关推荐Polly v8 实战指南用 ResiliencePipeline 构建 .NET 弹性与瞬时故障处理策略Polly v8 实战指南用 ResiliencePipeline 构建 .NET 弹性与瞬时故障处理策略 本篇技术指南以仓库根目录 README.md ht后端微服务Self-Evolving Agents入门从LLM基础到自主进化的完整教程Self Evolving Agents入门从LLM基础到自主进化的完整教程 Self Evolving Agents自进化智能体是人工智能领域的前沿技术ASP.NET Core 弹性 HTTP 客户端使用 Microsoft.Extensions.Http.Polly 为 IHttpClientFactory 集成重试、熔断与超时策略ASP.NET Core 弹性 HTTP 客户端使用 Microsoft.Extensions.Http.Polly 为 IHttpClientFactory后端Web框架上一篇如何用AI实时分析麻将对局Akagi 上手实战指南下一篇Type Challenges 中等难度 Diff 题解用 keyof、Exclude 与映射类型实现对象对称差创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
