0

0

C# Polly策略包装方法 C#如何组合多个Polly策略

幻夢星雲

幻夢星雲

发布时间:2026-02-06 10:17:02

|

332人浏览过

|

来源于php中文网

原创

用 Policy.WrapAsync(或 Wrap)将多个策略按执行顺序嵌套包装,外层控整体(如超时),内层处理细节(如重试、熔断);顺序决定生效优先级,类型须一致,异常为最内层原始异常。

c# polly策略包装方法 c#如何组合多个polly策略

多个Polly策略怎么串起来用

直接说结论:用 Policy.WrapAsync(或 Policy.Wrap)把多个策略按执行顺序“包”成一个,不是简单叠加,而是形成嵌套调用链。外层策略控制整体行为(比如超时),内层策略处理具体异常(比如重试、熔断)。

常见错误是把 RetryPolicyCircuitBreakerPolicy 分开 await,结果重试逻辑完全绕过熔断器;或者误用 .Or() 想合并策略——那只是扩展异常类型匹配,不是组合策略行为。

  • Wrap 的顺序很重要:最外层策略最先生效,最内层策略最接近实际委托。例如 TimeoutPolicy.WrapAsync(RetryPolicy.WrapAsync(CircuitBreakerPolicy)) 表示:先走熔断判断 → 再决定是否重试 → 最后被超时兜底中断
  • 所有被包装的策略必须类型一致:要么全是 AsyncPolicy,要么全是 AsyncPolicy(无返回值)。混用会导致编译失败
  • 如果策略里用了 Context(比如传 "operation-id"),外层策略的 Context 会透传给内层,但各策略的 onRetry / onBreak 回调中拿到的 Context 是同一份引用,注意别意外覆盖

带返回值的异步策略怎么包装

处理 HTTP 调用这类有返回值的场景,必须用泛型版本的 WrapAsync,否则编译不通过。策略声明和包装都得对齐类型。

例如封装一个带熔断 + 重试 + 超时的 HttpClient.GetAsync 调用:

var circuitBreaker = Policy
    .Handle()
    .CircuitBreakerAsync(5, TimeSpan.FromMinutes(1));

var retry = Policy .Handle() .OrResult(r => !r.IsSuccessStatusCode) .WaitAndRetryAsync(new[] { TimeSpan.FromSeconds(1), TimeSpan.FromSeconds(2) });

var timeout = Policy.TimeoutAsync(5);

var wrapped = Policy.WrapAsync(circuitBreaker, retry, timeout); // 注意顺序

C知道
C知道

CSDN推出的一款AI技术问答工具

下载

// 使用时: var response = await wrapped.ExecuteAsync(() => client.GetAsync("https://www.php.cn/link/710ba53b0d353329706ee1bedf4b9b39"));

关键点:OrResult 用于捕获“成功返回但业务失败”的情况(如 500 响应),它和 Handle 是并列条件,不是嵌套关系;TimeoutAsync 的泛型参数必须和实际委托返回类型严格一致。

同步策略包装要注意什么

同步策略用 Policy.Wrap,但实际项目中极少单独使用——因为现代 C# I/O 几乎都是异步的。唯一常见同步场景是包装本地计算型操作(比如 JSON 解析、内存缓存查找),且明确不希望引入 async/await 开销。

  • 不要把异步策略塞进 Policy.Wrap:比如把 Policy.Handle().RetryAsync() 传给 Wrap,编译报错 Cannot convert async lambda
  • 同步包装链里所有策略必须是 PolicyPolicy,不能混入 AsyncPolicy 类型
  • 如果原操作是 Func,包装后调用 Execute;如果是 Action,则用 Execute 无返回版

策略组合后异常怎么捕获

包装后的策略执行失败时,抛出的异常是**最内层触发策略的原始异常**,不会自动包装成新类型。比如熔断器打开时抛 BrokenCircuitException,超时抛 TimeoutRejectedException,重试耗尽抛最后一次的 HttpRequestException

这意味着你不能只 catch Exception 就完事,得按需区分处理:

  • 想统一记录所有失败?用 ExecuteAndCaptureAsync 获取 PolicyResult,检查 FinalException 属性
  • 想对超时单独告警?在 ExecuteAsync 外层 try/catch TimeoutRejectedException
  • 熔断状态变化需要监听?必须在定义 CircuitBreakerPolicy 时传入 onBreakonReset 回调,包装后这些回调依然有效

最容易被忽略的是:当多个策略都配置了 onRetry,它们会按包装顺序从外到内依次触发——但如果你没给每个策略配不同的日志前缀,根本分不清哪条日志属于哪个策略。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

428

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

541

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

313

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

78

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

585

2023.08.02

lambda表达式
lambda表达式

Lambda表达式是一种匿名函数的简洁表示方式,它可以在需要函数作为参数的地方使用,并提供了一种更简洁、更灵活的编码方式,其语法为“lambda 参数列表: 表达式”,参数列表是函数的参数,可以包含一个或多个参数,用逗号分隔,表达式是函数的执行体,用于定义函数的具体操作。本专题为大家提供lambda表达式相关的文章、下载、课程内容,供大家免费下载体验。

209

2023.09.15

python lambda函数
python lambda函数

本专题整合了python lambda函数用法详解,阅读专题下面的文章了解更多详细内容。

191

2025.11.08

Python lambda详解
Python lambda详解

本专题整合了Python lambda函数相关教程,阅读下面的文章了解更多详细内容。

58

2026.01.05

java连接字符串方法汇总
java连接字符串方法汇总

本专题整合了java连接字符串教程合集,阅读专题下面的文章了解更多详细操作。

22

2026.02.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.9万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号