SuperAPI AI 工具集

dotnet-resilience

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:为 .NET 应用引入现代容错模式,基于 Polly v8 与 Microsoft.Extensions.Http.Resilience,覆盖标准弹性管道、自定义管道配置及依赖注入集成。

主要能力:标准弹性管道按推荐顺序分层——限流、总超时、重试、熔断、单次尝试超时;支持通过选项自定义重试次数、退避类型、抖动、熔断阈值与超时;支持用 Polly v8 构建自定义管道(重试、熔断、超时、组合策略、类型化管道、对冲策略);通过 DI 注册并注入 ResiliencePipeline;内置遥测指标(polly.strategy.attempt.duration、pipeline.duration、attempt.count),配合 OpenTelemetry 使用。

使用方式:安装 Microsoft.Extensions.Http.Resilience(传递引入 Polly v8 与 Microsoft.Extensions.Resilience),非 HTTP 场景可仅装 Microsoft.Extensions.Resilience。HTTP 客户端调用 .AddStandardResilienceHandler() 应用默认管道,或传入 options 自定义;非 HTTP 用 AddResiliencePipeline 注册命名管道,再通过 [FromKeyedServices] 注入使用。选项可绑定 appsettings.json 分环境配置。

适用场景:HTTP 调用、数据库操作、消息队列、文件 I/O 等需要重试与熔断的场合;对冲策略仅适用于幂等操作(如 GET、只读查询)。

限制:Microsoft.Extensions.Http.Polly 已被取代,新项目不应使用;Polly v7 与 v8 API 不兼容;不要重复添加 AddStandardResilienceHandler;单次尝试超时须短于总超时;不要重试非幂等操作;生产环境避免硬编码重试延迟,应启用抖动。DI 机制、异步取消传播、HTTP 客户端工厂、策略测试等不在本技能范围内。