C#弹性治理：Polly在分布式系统中的应用与实践

1. Polly：C#开发者的弹性治理利器

在分布式系统和微服务架构中，网络抖动、服务超时、数据库连接中断等问题几乎不可避免。作为一名长期奋战在一线的.NET开发者，我深刻体会到传统try-catch异常处理方式的局限性——它只能被动捕获异常，却无法主动应对这些故障。Polly的出现彻底改变了这一局面，它通过声明式的策略配置，让我们的应用具备了自我修复和抗雪崩的能力。

Polly是.NET生态中最成熟的弹性治理库，它封装了重试、熔断、超时等核心策略，以极其简洁的语法帮助我们构建健壮的应用程序。不同于其他臃肿的框架，Polly轻量且专注，没有任何冗余依赖，完全兼容.NET Standard 2.0及以上版本，可以无缝集成到各种.NET项目中。

在实际开发中，Polly主要解决了三大核心痛点：

1. 防止级联故障：当下游服务出现问题时，能够有效隔离故障，避免请求堆积拖垮上游服务
2. 实现故障自愈：针对网络抖动等临时性故障，可以自动重试恢复，减少人工干预
3. 保护系统资源：通过限流和隔离机制，防止单一故障耗尽线程池、连接池等关键资源

2. 环境准备与基础配置

2.1 安装与命名空间

Polly的安装非常简单，通过NuGet包管理器即可完成。根据项目需求，我们可以选择安装不同的包：

bash复制# 核心包（必装）
dotnet add package Polly

# HttpClient集成包（推荐）
dotnet add package Microsoft.Extensions.Http.Polly

# 扩展包（按需安装）
dotnet add package Polly.Extensions.Http

安装完成后，需要引入以下核心命名空间：

csharp复制using Polly;                  // 核心策略
using Polly.CircuitBreaker;   // 熔断策略
using Polly.Fallback;         // 回退策略
using Polly.Retry;            // 重试策略
using Polly.Timeout;          // 超时策略
using Polly.Bulkhead;         // 限流策略
using Polly.Wrap;             // 策略组合

2.2 基础策略概览

Polly提供了六大核心策略，覆盖了绝大多数日常开发场景：

1. 重试策略(Retry)：处理临时性故障
2. 熔断策略(Circuit Breaker)：防止系统雪崩
3. 回退策略(Fallback)：提供故障兜底
4. 超时策略(Timeout)：防止资源阻塞
5. 舱壁策略(Bulkhead)：实现资源隔离
6. 策略组合(PolicyWrap)：组合多种策略

3. 核心策略详解与实战

3.1 重试策略：应对临时故障

重试策略是处理临时性故障的首选方案。当遇到网络抖动或服务偶发超时时，合理的重试机制可以显著提高请求成功率。

csharp复制var retryPolicy = Policy<HttpResponseMessage>
    .Handle<HttpRequestException>() // 捕获网络异常
    .OrResult(resp => !resp.IsSuccessStatusCode) // 捕获非成功响应
    .WaitAndRetryAsync(
        retryCount: 3,
        sleepDurationProvider: (attempt, _) => 
            TimeSpan.FromSeconds(Math.Pow(2, attempt)) + 
            TimeSpan.FromMilliseconds(new Random().Next(100, 300)),
        onRetryAsync: (ex, span, attempt, _) => 
        {
            Console.WriteLine($"第{attempt}次重试，间隔{span.TotalSeconds}s");
            return Task.CompletedTask;
        });

关键参数解析：

• retryCount：最大重试次数，建议2-3次
• sleepDurationProvider：重试间隔，推荐使用指数退避算法
• onRetryAsync：重试回调，可用于记录日志或发送告警

重要提示：使用重试策略时必须确保操作具有幂等性，否则可能导致数据不一致问题。

3.2 熔断策略：防止系统雪崩

熔断策略是分布式系统中的"保险丝"，当故障达到阈值时自动切断请求，避免系统被拖垮。

csharp复制var circuitBreakerPolicy = Policy<HttpResponseMessage>
    .Handle<HttpRequestException>()
    .OrResult(resp => resp.StatusCode == HttpStatusCode.InternalServerError)
    .CircuitBreakerAsync(
        exceptionsAllowedBeforeBreaking: 5,
        durationOfBreak: TimeSpan.FromSeconds(10),
        onBreak: (ex, span) => Console.WriteLine($"熔断触发，断开{span.TotalSeconds}s"),
        onReset: () => Console.WriteLine($"熔断恢复"),
        onHalfOpen: () => Console.WriteLine($"进入半开状态"));

状态机工作原理：

1. Closed（闭合）：正常状态，请求直接通过
2. Open（断开）：熔断状态，所有请求被拒绝
3. Half-Open（半开）：试探状态，允许少量请求通过

3.3 回退策略：优雅降级

当所有策略都失败时，回退策略可以提供友好的降级响应，保证用户体验。

csharp复制var fallbackPolicy = Policy<HttpResponseMessage>
    .Handle<Exception>()
    .OrResult(resp => !resp.IsSuccessStatusCode)
    .FallbackAsync(
        fallbackValue: new HttpResponseMessage(HttpStatusCode.ServiceUnavailable)
        {
            Content = new StringContent("服务繁忙，请稍后重试")
        },
        onFallbackAsync: (ex, _) => 
        {
            Console.WriteLine($"触发降级：{ex.Exception?.Message}");
            return Task.CompletedTask;
        });

4. 高级应用与集成

4.1 策略组合实战

实际项目中，我们通常需要组合多种策略来应对复杂场景。Polly提供了PolicyWrap来实现策略组合。

csharp复制// 定义各子策略
var timeout = Policy.TimeoutAsync(3);
var retry = Policy<HttpResponseMessage>.Handle<Exception>().WaitAndRetryAsync(2, _ => TimeSpan.FromSeconds(1));
var circuitBreaker = Policy<HttpResponseMessage>.Handle<Exception>().CircuitBreakerAsync(3, TimeSpan.FromSeconds(10));
var fallback = Policy<HttpResponseMessage>.Handle<Exception>().FallbackAsync(new HttpResponseMessage(HttpStatusCode.ServiceUnavailable));

// 组合策略
var policyWrap = Policy.WrapAsync(fallback, retry, circuitBreaker, timeout);

// 执行策略
var response = await policyWrap.ExecuteAsync(async () => 
{
    var client = new HttpClient();
    return await client.GetAsync("https://api.example.com/data");
});

4.2 ASP.NET Core集成

在ASP.NET Core项目中，我们可以通过IHttpClientFactory与Polly无缝集成：

csharp复制builder.Services.AddHttpClient("ExternalApi", client => 
{
    client.BaseAddress = new Uri("https://api.example.com/");
})
.AddPolicyHandler(Policy<HttpResponseMessage>
    .HandleResult(resp => !resp.IsSuccessStatusCode)
    .WaitAndRetryAsync(2, _ => TimeSpan.FromSeconds(1)))
.AddPolicyHandler(Policy<HttpResponseMessage>
    .HandleResult(resp => !resp.IsSuccessStatusCode)
    .CircuitBreakerAsync(3, TimeSpan.FromSeconds(10)))
.AddPolicyHandler(Policy.TimeoutAsync(3));

5. 避坑指南与最佳实践

5.1 重试策略注意事项

1. 幂等性保障：对于非幂等操作（如创建订单），必须结合业务唯一标识避免重复执行
2. 避免重试风暴：使用指数退避+随机抖动，合理设置重试次数
3. 精准触发条件：仅对临时性故障（如网络异常、503错误）进行重试

5.2 熔断策略调优建议

1. 阈值设置：exceptionsAllowedBeforeBreaking建议3-5次，避免过于敏感
2. 熔断时长：根据下游服务恢复时间调整，通常在30秒到5分钟之间
3. 半开状态监控：密切观察半开状态的请求成功率

5.3 通用最佳实践

1. 完善的监控：记录所有策略的触发情况，便于问题排查
2. 环境差异化配置：开发环境可适当放宽策略限制
3. 策略复用：通过工厂模式封装常用策略
4. 资源清理：配合CancellationToken确保资源及时释放

6. 实战案例：订单服务集成

让我们看一个完整的订单服务集成库存服务的案例：

csharp复制public static class InventoryPolicyFactory
{
    public static IAsyncPolicy<HttpResponseMessage> CreatePolicy()
    {
        var timeout = Policy.TimeoutAsync(3);
        
        var retry = Policy<HttpResponseMessage>
            .Handle<HttpRequestException>()
            .OrResult(resp => resp.StatusCode is HttpStatusCode.RequestTimeout 
                or HttpStatusCode.InternalServerError)
            .WaitAndRetryAsync(2, attempt => TimeSpan.FromSeconds(Math.Pow(2, attempt)));
            
        var circuitBreaker = Policy<HttpResponseMessage>
            .Handle<HttpRequestException>()
            .OrResult(resp => resp.StatusCode == HttpStatusCode.InternalServerError)
            .CircuitBreakerAsync(3, TimeSpan.FromSeconds(30));
            
        var fallback = Policy<HttpResponseMessage>
            .Handle<Exception>()
            .OrResult(resp => !resp.IsSuccessStatusCode)
            .FallbackAsync(() => Task.FromResult(new HttpResponseMessage(HttpStatusCode.OK)
            {
                Content = new StringContent("{\"Success\":false,\"Message\":\"库存服务繁忙\"}")
            }));
            
        return Policy.WrapAsync(fallback, retry, circuitBreaker, timeout);
    }
}

在实际项目中使用Polly后，我们的系统稳定性得到了显著提升。特别是在促销活动期间，即使部分下游服务出现波动，核心业务流程仍能保持正常运行。