Polly API 购买：构建弹性应用与故障恢复的最佳实践

Polly 是一个强大的 .NET 弹性和瞬态故障处理库，其核心功能之一就是重试策略（Retry）。在现代应用程序开发中，处理瞬时故障、超时和异常对于确保应用程序的稳定性至关重要。而结合 IronPDF 等工具的使用，Polly 的应用场景更为广泛。本文将围绕 Polly API 购买 这个关键词展开，详细介绍 Polly 的重试策略、其与 IronPDF 的结合使用，以及如何通过 Polly 构建更具弹性的系统。

什么是 Polly API？

Polly 是一个开源的 .NET 库，专注于为开发人员提供弹性策略以应对瞬时故障和异常场景。其核心功能包括重试（Retry）、断路器（Circuit Breaker）、超时（Timeout）等策略，这些功能可以大幅提升应用程序的健壮性。

Polly 的主要优点：

灵活配置重试策略： 支持自定义重试次数、延迟时间和失败条件。
组合策略： 可以将多种策略（如重试与断路器）组合使用。
与第三方库集成： 例如与 IronPDF 集成，处理生成 PDF 时的瞬时故障。

相关图片链接：

为什么需要 Polly 的重试策略？

在分布式系统或微服务架构中，某些操作可能因网络波动、服务短暂不可用等原因而失败。这些问题通常是暂时的，通过 Polly 的重试策略可以显著提高系统的容错能力。

Polly 的优势

自动化错误恢复： 开发人员无需手动处理临时故障，Polly 自动重试失败的操作。
增强用户体验： 减少因故障导致的系统崩溃或用户操作中断。
提高系统稳定性： 通过有效的错误处理机制，确保系统在高负载或异常情况下依然可以正常运行。

代码示例：

using Polly;

var retryPolicy = Policy
    .Handle()
    .WaitAndRetry(
        retryCount: 3,
        sleepDurationProvider: attempt => TimeSpan.FromSeconds(Math.Pow(2, attempt)),
        onRetry: (exception, retryCount, context) =>
        {
            Console.WriteLine($"Retry {retryCount} due to {exception.Message}");
        });

相关图片链接：

Polly 的核心功能模块

重试策略（Retry）

Polly 的重试策略允许开发者自定义重试规则，包括：

最大重试次数。
每次重试的延迟时间。
是否使用指数回退策略。

代码示例：设置固定延迟的重试策略

var retryPolicy = Policy
    .Handle()
    .WaitAndRetry(
        3, // 最大重试次数
        retryAttempt => TimeSpan.FromSeconds(2), // 固定延迟时间
        (exception, timeSpan, retryCount, context) =>
        {
            Console.WriteLine($"Retry {retryCount} due to {exception.Message}");
        });

使用场景：
比如调用第三方 API 时，如果返回超时或连接异常，可以通过 Polly 自动重试，避免用户体验受到影响。

指数后退（Exponential Backoff）

指数后退是 Polly 提供的一种高级重试策略。每次重试之间的延迟时间呈指数增长，可以有效防止过于频繁的重试导致系统压力增加。

代码示例：指数后退策略

var retryPolicy = Policy
    .Handle()
    .WaitAndRetry(
        retryCount: 3,
        sleepDurationProvider: attempt => TimeSpan.FromSeconds(Math.Pow(2, attempt)),
        onRetry: (exception, retryCount, context) =>
        {
            Console.WriteLine($"Retry {retryCount} due to {exception.Message}");
        });

相关图片链接：

断路器策略（Circuit Breaker）

断路器策略可以在服务持续失败时暂时停止请求，避免系统资源被耗尽。

代码示例：重试与断路器的组合

var circuitBreakerPolicy = Policy
    .Handle()
    .CircuitBreaker(
        exceptionsAllowedBeforeBreaking: 3,
        durationOfBreak: TimeSpan.FromSeconds(30),
        onBreak: (ex, breakDelay) =>
        {
            Console.WriteLine($"Circuit broken due to {ex.Message}");
        },
        onReset: () =>
        {
            Console.WriteLine("Circuit reset.");
        });

var policyWrap = Policy.Wrap(retryPolicy, circuitBreakerPolicy);

相关图片链接：

IronPDF 与 Polly 的结合使用

IronPDF 是一个功能强大的 .NET PDF 库，支持将 HTML、CSS 转换为 PDF 文件。结合 Polly，可以优雅地处理在生成 PDF 过程中可能出现的瞬态故障。

安装 IronPDF 和 Polly

在项目中使用以下命令安装 IronPDF 和 Polly：

Install-Package IronPdf
Install-Package Polly

示例：使用 Polly 重试生成 PDF

以下代码展示了如何模拟从 API 获取数据，并在生成 PDF 时处理瞬时故障。

代码示例：


using IronPdf;
using Polly;

var retryPolicy = Policy
    .Handle()
    .WaitAndRetryAsync(
        3,
        retryAttempt => TimeSpan.FromSeconds(2),
        (exception, retryCount, context) =>
        {
            Console.WriteLine($"Retry {retryCount} due to {exception.Message}");
        });

var pdf = await retryPolicy.ExecuteAsync(async () =>
{
    var data = await FetchDataFromExternalApiAsync();
    return GeneratePdfFromData(data);
});

pdf.SaveAs("GeneratedDocument.pdf");

static async Task FetchDataFromExternalApiAsync()
{
    // 模拟外部 API 数据获取
    await Task.Delay(100);
    throw new HttpRequestException("Failed to fetch data");
}

static PdfDocument GeneratePdfFromData(string data)
{
    var renderer = new ChromePdfRenderer();
    return renderer.RenderHtmlAsPdf($