C# Academy · 课时

弹性管道

Q: 「弹性管道」这节课中我会学到什么？

将多种策略组合为弹性管道。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

将多种策略组合为弹性管道。

弹性管道 是 CoddyKit 上的免费 C# Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 4 节课。

组合策略

实际的弹性处理通常需要多个策略协同工作。Polly v8 允许您使用 ResiliencePipelineBuilder 将它们组合成一个弹性 pipeline。

ResiliencePipelineBuilder

您可以链式调用 Add... 方法，最后调用 Build()。结果是一个可复用、线程安全的 ResiliencePipeline，您可以通过它执行调用。

var pipeline = new ResiliencePipelineBuilder()
    .AddRetry(new RetryStrategyOptions())
    .AddTimeout(TimeSpan.FromSeconds(5))
    .Build();

顺序很重要

策略会从外向内执行：最先添加的策略会包装其余策略。一个常见且正确的顺序是，将每次尝试的超时放在重试内部，再在它们外层包裹总超时和熔断器。

var pipeline = new ResiliencePipelineBuilder()
    .AddTimeout(TimeSpan.FromSeconds(10))      // overall
    .AddRetry(new RetryStrategyOptions())
    .AddCircuitBreaker(new CircuitBreakerStrategyOptions())
    .AddTimeout(TimeSpan.FromSeconds(2))       // per attempt
    .Build();

带类型的管道

当策略需要检查结果（例如回退或基于结果的重试）时，请使用泛型 ResiliencePipelineBuilder<T>，这样管道就知道返回类型。

var pipeline = new ResiliencePipelineBuilder<HttpResponseMessage>()
    .AddRetry(new HttpRetryStrategyOptions())
    .Build();

带状态执行

为了避免闭包产生分配，请将状态传递给 ExecuteAsync；Polly 会将该状态传回您的回调。

await pipeline.ExecuteAsync(
    static async (state, token) => await state.CallAsync(token),
    myService);

ResiliencePipelineProvider

您不必在调用位置内联构建管道，而是可以在 DI 中注册带名称的管道，并通过 ResiliencePipelineProvider 解析它们。这样可以集中管理配置。

builder.Services.AddResiliencePipeline("db", pipeline =>
{
    pipeline.AddRetry(new RetryStrategyOptions())
            .AddTimeout(TimeSpan.FromSeconds(3));
});

解析带名称的管道

注入 ResiliencePipelineProvider<string>，并在需要的地方通过键获取您的管道。

public class OrderService
{
    private readonly ResiliencePipeline _pipeline;
    public OrderService(ResiliencePipelineProvider<string> provider)
    {
        _pipeline = provider.GetPipeline("db");
    }
}

HttpClient 的弹性处理

AddResilienceHandler 扩展会将管道附加到带类型或带名称的 HttpClient，并将其应用于每个传出的请求。

builder.Services.AddHttpClient<CatalogClient>()
    .AddResilienceHandler("catalog", b =>
    {
        b.AddRetry(new HttpRetryStrategyOptions());
        b.AddCircuitBreaker(new HttpCircuitBreakerStrategyOptions());
    });

标准弹性处理程序

Microsoft 提供了开箱即用的 AddStandardResilienceHandler，按照推荐顺序打包了合理的重试、熔断器、超时和限流策略。

builder.Services.AddHttpClient<CatalogClient>()
    .AddStandardResilienceHandler();

管道可复用且开销低

只需构建一次管道，就可以将其用于多次执行。管道不可变且线程安全，因此共享使用既安全又高效。

可观测性挂钩

每个策略都会公开回调（OnRetry、OnOpened、OnTimeout、OnFallback），Polly 还会发出遥测数据，您可以将其接入日志记录和指标系统，以获得完整的可见性。

快速检查

测试弹性管道。

回顾

ResiliencePipelineBuilder 会将重试、熔断器、超时和回退组合成一个可复用的管道；执行顺序是从外向内，因此顺序很重要。对于需要感知结果的策略，请使用泛型构建器；使用 AddResiliencePipeline 注册带名称的管道，并通过 ResiliencePipelineProvider 解析它们。对于 HTTP，AddResilienceHandler 或 AddStandardResilienceHandler 可以保护每个请求。

常见问题解答

「弹性管道」课时是免费的吗？

是的 — 「弹性管道」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 4 节课。

「弹性管道」这节课中我会学到什么？

将多种策略组合为弹性管道。你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 C# Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「弹性管道」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 C# Academy 课中编写并运行代码吗？

能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 C# Academy