ASP.Net Core2.1中的HttpClientFactory系列二：集成Polly处理瞬态故障

 

　　前言：最近，同事在工做中遇到了使用HttpClient,有些请求超时的问题，辅导员让我下去调研一下，HttpClinet的使用方式已经改为了以前博客中提到的方式，问题的缘由我已经找到了，就是由于使用了伪异步，致使阻塞主线程。在以前的博客中有园友，建议在使用静态的HttpClinet时务必使用它的Async方法，因此就得从头至尾异步化。这一点在以前的文章中没有提，这里做为补充，也感谢这位园友。关于怎么使用异步编程，在这里我就不聊了，你们能够看看其余的博客，看完公司的代码以后，我想强调的是，在使用异步编程的时候，关于返回值的问题：

为何async方法返回的一般都是Task或者Task<T>，而不是T自己？这是由于，Task和Task<T>表明着在未来某一个时刻将会返回T类型的结果。所以，在主线程调用HttpPostWhitStrBody时，实际上你拿到的是一个将来才会发生的预期，也就是将来的某一个时间会获得一个string的结果。若是返回的是一个T自己，那么，在主线程调用时就会由于访问这个须要一段时间才能给出结果，从而阻塞了主线程。所以，若是async方法有返回值，应返回Task<T>。若是没有返回值，应该返回Task。你们若是不太明白的话，建议多了解一下C#中的异步编程。好了，前戏太多了，下面就来聊聊如何集成Polly。

 

1、在异步编程中如何处理异常信息

在聊如何集成Polly前，咱们先来看看在异步编程中如何处理异常。当异步操做发生异常的时候，异常会停留在异步方法中，调用方法没法直接看到，所以，咱们应该异步方法中处理异常，而不是在调用方法中处理异常。若是咱们使用了await修饰了任务，那么，只须要为它包上一层try-catch就能够了。固然了，也能够在调用方法（好比Main方法中）捕捉异常，这就须要异常从异步方法中传播给调用方法。作到这件事是很容易的，只须要两个条件：

（1）调用方法自己也是async的，而且，在内部调用异步方法，并使用await。

（2）异步方法返回Task或者Task<T>

由于C#不容许在Main方法中使用async（在C#7.1中，可使用async修饰Main方法了），所以，咱们不得再也不建立一层方法，下面经过代码演示一下。

using System;
using System.Threading;
using System.Threading.Tasks;

namespace ConsoleApp3
{
    class Program
    {
        static void Main(string[] args)
        {

            Caller();


            Console.ReadKey();
        }

        static async void Caller()
        {
            try
            {
                await UseAsync(0);
            }
            catch (AggregateException e)
            {

                Console.WriteLine(e.Message);
            }
        }

        static async Task<bool> UseAsync(int number)
        {
            Console.WriteLine("异步方法运行："+ Thread.CurrentThread.ManagedThreadId);
            var ret = await Task.Run(() => IsPrimeLowAsync(number));

            return ret;
        }


        static bool IsPrimeLowAsync(int number)
        {
            if (number <= 0) throw new AggregateException("输入必须大于0");
            if (number == 1) return false;

            for (int i = 0; i < number; i++)
            {
                if (number % i == 0) return false;
            }

            return true;
        }
    }
}

View Code

 

通常在处理异常的时候，咱们都是采用 try-catch来作处理的，若咱们想重试三次，此时咱们只能进行循环三次操做。咱们只能简单进行处理，自从有了Polly，什么重试机制，超时都不在话下，下面把话题转向Polly。

在聊下面的话题时，建议你们先认真阅读一下这篇博客，由于博主讲的很是细致：Polly

 

2、集成Polly，处理HTTP请求过程当中的瞬时故障

 　　Polly是一种流行的瞬态故障处理库，它提供了一种机制来定义可在某些故障发生时应用的策略。 最经常使用的策略之一就是重试策略。 这中策略容许您包装一些代码，若是发生故障，将重试这些代码; 必要时也能够重试屡次。 这在您的应用程序须要与外部服务通讯的状况下很是有用。 当经过HTTP与服务进行通讯时，会出现瞬态故障，这种风险始终存在。 瞬态故障可能会阻碍您的请求完成，可是瞬态故障也多是暂时性的问题。所以， 这使得在这些状况下重试成为明智的选择。

 　　除了重试以外，Polly还提供了许多其余类型的策略，其中许多策略可能须要与重试相结合，以构建处理故障的复杂方法。 我将在本文中介绍一些更通常的例子，可是若是你想要更全面的了解，我建议你查看一下Polly wiki。

• 　　使用Polly

　　ASP.NET团队与Polly的主要维护者Dylan和Joel密切合做，使得将Polly策略应用于HttpClient实例很是简单。在开始以前咱们先引用下面的两个包：

　　

 　　这个Microsoft.Extensions.Http.Polly包在IHttpClientBuilder上包含一个名为AddPolicyHandler的扩展方法，咱们可使用它来添加一个handler ，该handler 将使用一个Polly实例，来包装请求。 

　　咱们能够用这个扩展在咱们的ConfigureServices 方法中，代码以下：

　　

 services.AddHttpClient("github")
  .AddPolicyHandler(Policy.TimeoutAsync<HttpResponseMessage>(TimeSpan.FromSeconds(10)));

 

　　在这个例子中，咱们定义了一个名字为“github”的客户端，而且咱们使用AddPolicyHandler 方法来添加了一种处理超时的策略，这里提供的超时策略，必须是IAsyncPolicy<HttpResponseMessage>，这个中策略在任何请求超过10s都会触发。

•  　　重试策略

　　若是可能的话，当咱们在使用Polly时，最好的尝试是，定义一次策略并在应用相同策略的状况下共享它们，这样要更改策略，只需在一个位置进行更改。此外，它还确保仅分配策略一次。固然了，若是多个使用者但愿经过相同的断路器实例运行，则须要共享诸如断路器之类的策略。不太理解，没关系，下面看代码，体会一下。

var retryPolicy = Policy.TimeoutAsync<HttpResponseMessage>(TimeSpan.FromSeconds(10));

services.AddHttpClient("github")
  .AddPolicyHandler(retryPolicy);

services.AddHttpClient("google")
  .AddPolicyHandler(retryPolicy);

• 　　瞬时错误处理

　　

处理HTTP请求时，咱们要处理的最常的问题就是瞬态故障。 因为这是一个常见的要求，Microsoft.Extensions.Http.Polly软件包中包含一个特定的扩展，咱们可使用它来快速设置处理瞬时故障的策略。

例如，要在指定客户端的请求发生瞬时故障时添加基本重试，咱们能够按以下方式注册重试策略：

services.AddHttpClient("github")
  .AddTransientHttpErrorPolicy(p => p.RetryAsync(3));

 

代码的含义是，因此使用命名的HttpClient，发出的请求，只要遇到错误，就会重试三次。这个AddTransientHttpErrorPolicy 方法须要一个Func<PolicyBuilder<HttpResponseMessage>, IAsyncPolicy<HttpResponseMessage>>.类型的参数。此处的PolicyBuilder将预先配置为处理HttpRequestExceptions，任何返回5xx状态代码的响应以及具备408（请求超时）状态代码的任何响应。 这应该适用于许多状况。 若是您要求在其余条件下应用策略，则须要使用不一样的重载来传递更具体的策略。

　　咱们须要意识到， 在进行重试时，咱们须要考虑幂等性。 重试HTTP GET是一种很是安全的操做。由于HTTP GET自己就是幂等性的， 若是咱们调用一个方法但没有收到任何响应，咱们能够安全地重试调用而不会有任何危险。 可是，请考虑若是咱们重试HTTP POST请求会发生什么？ 在这种状况下，咱们必须更加当心，由于您的原始请求可能实际收到，但咱们收到的响应却显示失败。 在这种状况下，重试可能致使数据重复或下游系统中存储的数据损坏。 在这里，您须要更多地了解下游服务在屡次收到相同请求时将执行的操做。 重试是一种安全操做？ 当您拥有下游服务时，更容易控制它。 例如，您可使用一些惟一标识符来防止重复的POST。

　　若是您对下游系统的控制较少，或者您知道重复的POST可能会产生负面影响，则须要更仔细地控制策略。 可能适合的作法是定义不一样的命名/类型客户端。 您能够为那些没有反作用的请求建立一个，而为那些有反作用的请求建立另外一个。 而后，您可使用正确的客户端进行操做。 可是，这可能会变得有点难以管理。 更好的选择是使用AddPolicyHandler的重载，它容许咱们访问HttpRequestMessage，以即可以有条件地应用策略。 那个重载看起来像这样：AddPolicyHandler(Func<HttpRequestMessage, IAsyncPolicy<HttpResponseMessage>> policySelector)，您将注意到此处的policySelector委托能够访问HttpRequestMessage，而且应该返回IAsyncPolicy <HttpResponseMessage>。 咱们没法访问PolicyBuilder设置来处理瞬态错误，就像咱们在前面的示例中所作的那样。 若是咱们想要处理常见的瞬态错误，咱们须要为咱们的策略定义预期条件。 为了简化这一过程，Polly项目包含一个帮助扩展，咱们可使用它来设置一个准备好处理常见瞬态错误的PolicyBuilder。 要使用扩展方法，咱们须要从Nuget添加Polly.Extensions.Http包。

　　而后，咱们能够调用HttpPolicyExtensions.HandleTranisentHttpError（）来获取配置瞬态故障条件的PolicyBuilder。 咱们可使用该PolicyBuilder建立一个合适的重试策略，当请求是HTTP GET时，能够有条件地应用该策略。 在此示例中，任何其余HTTP方法都使用NoOp策略。

 

var retryPolicy = HttpPolicyExtensions
  .HandleTransientHttpError()
  .RetryAsync(3);

var noOp = Policy.NoOpAsync().AsAsyncPolicy<HttpResponseMessage>();

services.AddHttpClient("github")
  .AddPolicyHandler(request => request.Method == HttpMethod.Get ? retryPolicy : noOp);

• 　　使用PolicyRegistry

　　我想在本文中介绍的最后一个示例是如何从策略注册表中应用策略。 为了支持策略重用，Polly提供了PolicyRegistry的概念，PolicyRegistry本质上是策略的容器。 这些能够在应用程序启动时经过向注册表添加策略来定义。 而后能够传递注册表并用于按名称访问策略。IHttpClientBuilder上可用的扩展还支持使用注册表将基于Polly的处理程序添加到客户端。

 

var registry = services.AddPolicyRegistry();

var timeout = Policy.TimeoutAsync<HttpResponseMessage>(TimeSpan.FromSeconds(10));
var longTimeout = Policy.TimeoutAsync<HttpResponseMessage>(TimeSpan.FromSeconds(30));

registry.Add("regular", timeout);
registry.Add("long", longTimeout);

services.AddHttpClient("github")
    .AddPolicyHandlerFromRegistry("regular");

　　首先，咱们必须在DI中注册PolicyRegistry。 Microsoft.Extensions.Http.Polly包中包含一些扩展方法，以简化此操做。 在上面的示例中，我调用AddPolicyRegistry方法，该方法是IServiceCollection的扩展。 这将建立一个新的PolicyRegistry，并在DI中添加注册，做为IPolicyRegistry <string>和IReadOnlyPolicyRegistry <string>的实现。 该方法返回策略，以便咱们有权向其添加策略。

 在此示例中，咱们添加了两个超时策略并为其指定了名称。 如今，在注册客户端时，咱们能够调用IHttpClientBuilder上的AddPolicyHandlerFromRegistry方法。 这将采用咱们想要使用的策略的名称。 当工厂建立此命名客户端的实例时，它将添加适当的处理程序，在“regular”重试策略中包含调用，该策略将从注册表中检索。

 

示例项目：新建一个.Net Core 2.1的webapi项目：

Startup.cs文件的代码：

 public void ConfigureServices(IServiceCollection services)
        {



            services.AddHttpClient("GitHub", client =>
            {
                client.BaseAddress = new Uri("https://api.github.co");
                client.DefaultRequestHeaders.Add("Accept", "application/vnd.github.v3+json");
                client.DefaultRequestHeaders.Add("User-Agent", "HttpClientFactory-Sample");
            })
          .AddTransientHttpErrorPolicy(builder => builder.WaitAndRetryAsync(new[]
          {
            TimeSpan.FromSeconds(1),
            TimeSpan.FromSeconds(5),
            TimeSpan.FromSeconds(10)
          }));


            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
        }

 

注意：

WaitAndRetryAsync参数的意思是：每次重试时等待的睡眠持续时间。

ValuesController的代码：

private readonly IHttpClientFactory _httpClientFactory;

        public ValuesController(IHttpClientFactory   httpClientFactory)
        {
            _httpClientFactory = httpClientFactory;
        }
        // GET api/values
        [HttpGet]
        public async  Task<ActionResult> Get()
        {
            var client = _httpClientFactory.CreateClient("GitHub");
            string result = await client.GetStringAsync("/");
            return Ok(result);
        }

 

看到没，它在重试。

  更多的Polly和HttpClinetFactory的集成使用请参考：

https://github.com/App-vNext/Polly/wiki/Polly-and-HttpClientFactory

https://www.hanselman.com/blog/AddingResilienceAndTransientFaultHandlingToYourNETCoreHttpClientWithPolly.aspx

 

3、总结

　　注意：AddTransientHttpErrorPolicy方法会自动帮咱们处理如下错误：

　　（1）Network failures (System.Net.Http.HttpRequestException)

　　（2）HTTP 5XX status codes (server errors)

　　（3）HTTP 408 status code (request timeout)

 

　　经过这些库，您能够轻松地启动并运行可以无缝处理瞬态故障的HttpClient实例。 有关更详细的Polly文档和示例，建议您查看Polly wiki。这里只是聊了关于HttpClientFactory中集成Polly的基础用法，关于更详细的使用请参考：https://www.cnblogs.com/CreateMyself/p/7589397.html，好了今天就聊到这里，该系列文章还有最后一篇，对于Polly我也是刚接触，至于项目中是否使用还要通过辅导员的审核，但愿对你有帮助，谢谢。

 

 

 参考文章：

（翻译）https://www.stevejgordon.co.uk/httpclientfactory-using-polly-for-transient-fault-handling

 

做者：郭峥

出处：http://www.cnblogs.com/runningsmallguo/

本文版权归做者和博客园共有，欢迎转载，但未经做者赞成必须保留此段声明，且在文章页面明显位置给出原文连接。