深入理解 Polly：.NET Core 中的健壮错误处理策略

最新推荐文章于 2025-05-12 17:41:21 发布
最新推荐文章于 2025-05-12 17:41:21 发布
阅读量886 收藏 10
点赞数 28
分类专栏： Net core C# 文章标签： .netcore 服务器 c# microsoft .net
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_48916144/article/details/147880912
版权

在现代软件开发中，错误处理是构建高可用、健壮系统的关键之一。尤其是当应用依赖外部服务（如 API、数据库或其他网络资源）时，临时的服务中断、超时或其他不可预见的错误都会影响应用的稳定性。为了提升系统的容错能力，Polly 成为 .NET 开发者的重要工具。Polly 是一个功能强大的 .NET 库，提供了多种常用的错误处理策略，如重试、断路器、回退等，帮助开发者在发生错误时进行优雅的恢复和处理。

本文将深入探讨 Polly 的核心功能及其在 .NET Core 中的应用，带你一步步掌握如何通过 Polly 构建健壮的错误处理机制。

1. 什么是 Polly？

Polly 是一个为 .NET 提供的开源库，旨在帮助开发者处理常见的错误处理需求。Polly 提供了一套丰富的策略，用于解决应用在与外部服务交互时可能出现的瞬时错误。它的主要功能包括：

  • 重试（Retry）

  • 断路器（Circuit Breaker）

  • 回退（Fallback）

  • 超时（Timeout）

  • 并发限制（Bulkhead Isolation）

这些策略有助于在外部依赖出现问题时，保证系统能够优雅地恢复或避免过度依赖失败的服务。

2. Polly 核心策略

2.1 重试（Retry）

重试策略在遇到可恢复的错误时会自动重试失败的操作。比如，某个 HTTP 请求因为网络波动而失败，重试策略可以尝试再次发起请求，直到成功或达到最大重试次数。

示例代码：

using Polly;
using System;
using System.Net.Http;
using System.Threading.Tasks;

public class Program
{
    public static async Task Main(string[] args)
    {
        var policy = Policy
            .Handle<HttpRequestException>()  // 捕获 HttpRequestException 异常
            .RetryAsync(3);  // 重试 3 次

        HttpClient client = new HttpClient();

        await policy.ExecuteAsync(async () =>
        {
            var response = await client.GetAsync("https://example.com");
            response.EnsureSuccessStatusCode();  // 请求失败会抛出异常
            return response;
        });
    }
}

在上面的代码中，如果 HTTP 请求因某种原因失败，Polly 会自动重试最多 3 次。

2.2 断路器（Circuit Breaker）

断路器策略用于避免持续失败的操作对系统造成更大的影响。当一个操作连续失败多次时，断路器会启动，阻止进一步的请求执行，直到外部服务恢复正常。

示例代码：

using Polly;
using System;
using System.Net.Http;
using System.Threading.Tasks;

public class Program
{
    public static async Task Main(string[] args)
    {
        var policy = Policy
            .Handle<HttpRequestException>()
            .CircuitBreakerAsync(2, TimeSpan.FromMinutes(1));  // 2 次失败后断路，1 分钟内不再尝试

        HttpClient client = new HttpClient();

        try
        {
            await policy.ExecuteAsync(async () =>
            {
                var response = await client.GetAsync("https://example.com");
                response.EnsureSuccessStatusCode();
                return response;
            });
        }
        catch (BrokenCircuitException)
        {
            Console.WriteLine("Circuit is broken. Requests are not being executed.");
        }
    }
}

在这个例子中，如果 HTTP 请求连续失败两次，断路器就会打开，接下来的请求将不会再发送，直到 1 分钟后恢复正常。

2.3 回退（Fallback）

回退策略是在操作失败时提供一个备选方案。通常用于在外部服务调用失败时，返回默认数据或缓存内容，而不是直接报错。

示例代码：

using Polly;
using System;
using System.Net.Http;
using System.Threading.Tasks;

public class Program
{
    public static async Task Main(string[] args)
    {
        var fallbackPolicy = Policy
            .Handle<HttpRequestException>()
            .FallbackAsync(
                Task.FromResult("Fallback response"),  // 返回回退结果
                onFallbackAsync: (outcome, context) =>
                {
                    Console.WriteLine("Fallback triggered due to: " + outcome.Exception?.Message);
                    return Task.CompletedTask;
                });

        HttpClient client = new HttpClient();

        var result = await fallbackPolicy.ExecuteAsync(async () =>
        {
            var response = await client.GetAsync("https://example.com");
            response.EnsureSuccessStatusCode();
            return await response.Content.ReadAsStringAsync();
        });

        Console.WriteLine(result);  // 如果失败，返回回退结果
    }
}

当请求失败时，FallbackAsync 会提供一个替代方案（这里是一个字符串“Fallback response”），从而避免应用崩溃。

2.4 超时（Timeout）

超时策略限制了操作的最大执行时间。如果操作超时，Polly 会自动终止该操作。

示例代码：

using Polly;
using System;
using System.Net.Http;
using System.Threading.Tasks;

public class Program
{
    public static async Task Main(string[] args)
    {
        var timeoutPolicy = Policy
            .TimeoutAsync(TimeSpan.FromSeconds(5));  // 设置请求最大超时时间为 5 秒

        HttpClient client = new HttpClient();

        try
        {
            var result = await timeoutPolicy.ExecuteAsync(async () =>
            {
                var response = await client.GetAsync("https://example.com");
                response.EnsureSuccessStatusCode();
                return await response.Content.ReadAsStringAsync();
            });
        }
        catch (TimeoutRejectedException)
        {
            Console.WriteLine("The request timed out.");
        }
    }
}

在这个例子中，TimeoutAsync 设置了最大超时限制。如果请求没有在 5 秒内完成，将抛出 TimeoutRejectedException。

2.5 并行限制（Bulkhead Isolation）

并行限制策略用于限制系统能够同时处理的并发操作数量。如果超过最大并发数，后续请求将被排队或拒绝。

示例代码：

using Polly;
using System;
using System.Net.Http;
using System.Threading.Tasks;

public class Program
{
    public static async Task Main(string[] args)
    {
        var bulkheadPolicy = Policy
            .BulkheadAsync(2, 4);  // 最多 2 个并行请求，最多 4 个排队请求

        HttpClient client = new HttpClient();

        await Task.WhenAll(
            bulkheadPolicy.ExecuteAsync(async () =>
            {
                var response = await client.GetAsync("https://example.com");
                response.EnsureSuccessStatusCode();
            }),
            bulkheadPolicy.ExecuteAsync(async () =>
            {
                var response = await client.GetAsync("https://example.com");
                response.EnsureSuccessStatusCode();
            })
        );
    }
}

通过使用 BulkheadAsync，你可以避免系统因过多并发请求而崩溃，限制并发请求的数量，确保系统的稳定性。

3. 策略组合与复合策略

Polly 还支持将多个策略组合成一个复合策略（Policy Wrap）。这样，你可以在一个操作中依次应用多个策略，比如先尝试重试，接着使用断路器，最后返回回退结果。

示例代码：

using Polly;
using System;
using System.Net.Http;
using System.Threading.Tasks;

public class Program
{
    public static async Task Main(string[] args)
    {
        var policy = Policy
            .Handle<HttpRequestException>()
            .RetryAsync(3)
            .WrapAsync(
                Policy.Handle<HttpRequestException>()
                      .CircuitBreakerAsync(2, TimeSpan.FromMinutes(1))
            );

        HttpClient client = new HttpClient();

        try
        {
            await policy.ExecuteAsync(async () =>
            {
                var response = await client.GetAsync("https://example.com");
                response.EnsureSuccessStatusCode();
                return response;
            });
        }
        catch (BrokenCircuitException)
        {
            Console.WriteLine("The circuit is broken.");
        }
    }
}

通过 WrapAsync，你将重试策略和断路器策略结合起来，形成一个更复杂的容错处理机制。

4. 小结

Polly 为 .NET Core 应用提供了一种简洁而强大的错误处理机制。它的策略（重试、断路器、回退等）能够有效提高系统的稳定性，减少因外部服务不可用或临时故障而导致的系统崩溃。在实际开发中，合理利用 Polly 的策略，可以大大提升系统的健壮性和容错能力。

如果你还没有开始使用 Polly，不妨尝试在项目中引入它，特别是在与外部 API 或服务交互时，它能帮助你更好地处理瞬时故障，保证系统稳定运行。

.NET CORE微服务之Polly
m0_59178355的博客
03-11 2107
Polly是一个.NET Core微服务框架，用于实现容错、重试、熔断等策略。它可以帮助开发者在分布式系统中提高可靠性和稳定性。Polly提供了丰富的策略，如重试策略、熔断策略、超时策略等，可以灵活地应用于微服务架构中。通过使用Polly，开发者可以更好地处理异常情况，提高系统的可用性和性能。
.net core中间件Polly
10-29 1260
asp.net core中间件Polly
探索Polly：构建强大的.NET韧性与故障处理策略库
gitblog_00078的博客
05-09 456
探索Polly：构建强大的.NET韧性与故障处理策略库 PollyPolly is a .NET resilience and transient-fault-handling library that allows developers to express policies such as Retry, Circuit Breaker, Timeout, Bulkhead Isolation...
基于ASP.NET CORE 6 使用Polly来实现处理Http请求异常
m0_65664914的博客
07-29 701
Polly 是一个 .NET 弹性和瞬态故障处理库，旨在帮助开发者构建更健壮和可靠的应用程序。它提供了一系列策略，如重试、断路器、超时、回退和隔离等，用于处理瞬态故障和提高系统的弹性。通过这些示例，你可以看到如何使用 Polly 来增强 ASP.NET Core 应用程序的弹性和容错能力。根据具体的业务需求，可以灵活组合和调整这些策略。
ASP.NET Core 实现微服务 -- Polly 服务降级熔断
主宰
01-09 1098
通过以上文字我们大致了解了什么是服务降级、什么是熔断。并且通过 Polly 演示了如何处理这些情况。最后使用 lemon 大佬的 AspectCore 封装成一个 Attribute 来演示如何通过 AOP 的思想来简化 Polly 的使用。
.NET Core 中的异常处理
dotNET跨平台
03-29 437
概述：异常处理是软件开发的一个关键方面，可确保应用程序健壮且无错误。在 .NET Core 中，Microsoft 提供了一个用于管理异常的复杂框架，允许开发人员编写更可靠、可维护和用户友好的应用程序。本文深入探讨了 .NET Core 中的高级异常处理技术，并通过实际示例和 C# 代码片段进行了说明，以阐明复杂的概念。了解 .NET Core ???? 中的异常在深入研究高级概念之前，让我们先澄清一下...
.Net Core with 微服务 - Polly 服务降级熔断
zhanglong_longlong的专栏
08-25 325
在我们实施微服务之后，服务间的调用变的异常频繁。多个服务之间可能是互相依赖的关系。某个服务出现故障或者是服务间的网络出现故障都会造成服务调用的失败，进而影响到某个业务服务处理失败。某一个服务调用失败轻则造成当前相关业务无法处理；重则可能耗尽资源而拉垮整个应用。为了尽可能的保证我们生产环境的可用性，至少是部分可用性我们就需要一些策略来保护我们的服务。 服务降级 比如我们的订单详情服务里面会调用会员信息服务接口。如果会员信息服务接口故障会造成订单详情服务也同样故障。这时候我们可以对会员信息服务接口进行降级，
ASP.NET Core 实用类库
hy_4377的博客
08-06 452
随着 ASP.NET Core 的不断发展，它已经成为构建现代 Web 应用程序的主流框架。为了提高开发效率和代码质量，许多开发者使用各种实用类库来简化常见任务和增强应用程序功能。本文将介绍一些常用的 ASP.NET Core 实用类库，帮助你更高效地开发应用。
asp.net core 的中间件都有哪些--面试题
战族狼魂的博客
07-15 577
中间件
NetCore-Polly:在ASP.NET Core应用程序中检查Polly功能的游乐场
05-01
通过"NetCore-Polly"项目，开发者可以深入理解如何在实际应用中运用Polly，提升ASP.NET Core应用的稳定性和健壮性，同时掌握C#和ASP.NET Core的高级特性。这个项目提供了实践和学习这些概念的宝贵机会。
AspNetCoreEnterpriseApp:带有Web API，JWT，Polly，Refit，RabbitMQ等的ASP.NET Core App
03-19
- Polly的策略可以全局配置，也可以针对特定API调用局部应用，以提供灵活的错误处理策略。 - Refit通过接口定义REST API，使得接口方法自动映射到HTTP请求，返回类型则根据HTTP响应自动序列化。 - RabbitMQ使用AMQP...
深入Polly：构建健壮C#微服务应用的艺术
开发者需要深入理解Polly的工作原理和最佳实践来高效地在应用程序中集成Polly。 7. 示例项目分析： 通过解压缩包中的示例项目，我们可以看到Polly在实际项目中的应用情况。EOCS.Polly.FaultyService可能是一个故意...
DevExtreme JS & ASP.NET Core v25.1新功能预览 - 全新的Stepper组件
需要界面开发、IDE工具研发中文教程资料的小伙伴，记得私信我~
05-08 1030
界面控件DevExtreme JS & ASP.NET Core v25.1即将在6月更新，新版本发布全新的Stepper组件等，欢迎关注我们及时获取最新消息~
Asp.Net Core IIS发布后PUT、DELETE请求错误405
往事知多少？
05-08 274
一、方案11、IIS管理器，处理程序映射。2、找到aspNetCore，双击。点击请求限制...按钮，并在谓词选项卡上，添加两者DELETE和PUT.二、方案2打开web.config文件，添加<remove name="WebDAVModule" />，即可解决<modules><remove name="WebDAVModule" /></modules>
麒麟系统安装.net core环境变量
最新发布
啊鹏的博客
05-12 130
本文主要记录在麒麟系统上安装.net core的运行环境，这里使用的是麒麟V10桌面版，后续测试服务器到了之后再使用服务器版进行安装测试。
如何把ASP.NET Core WebApi打造成Mcp Server
c13_tianming的专栏
05-08 1133
关于MCP是什么相信大家已经很熟悉了。目前主流的AI开发框架和AI工具都支持集成MCP，这也正是它的意义所在。毕竟作为一个标准的协议，当然是更多的生态接入进来才会有意义。使用MCP我们可以把Tools调用标准化，这意味着我们可以忽略语言、框架快速把工具融合到不同的模型中去。
HTTP Error 500.31 - Failed to load ASP.NET Core runtime
往事知多少？
05-08 274
启动配置错误日志：打开web.config文件，修改stdoutLogEnabled="true"，如下图。根据日志下载对应的文件，执行，完成排查....Net Core程序启动失败的排查。
ASP.NET Core Identity框架使用指南
lei1083929965的博客
05-12 762
ASP.NET Core Identity 是一个用于管理用户身份验证、授权和用户信息的框架，它是 ASP.NET Core 平台的重要组成部分。它为开发者提供了一套完整的工具和 API，用于处理用户注册、登录、密码管理、角色权限、第三方登录（如 Google、Facebook）等常见功能。自定义用户类继承并扩展属性（如创建时间）：using Microsoft.AspNetCore.Identity;longset;自定义角色类继承。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值