Asp.Net Core 轻松学-HttpClient的演进和避坑

前言

    在 asp.net core 1.0 时代，由于设计上的问题， httpclient 给开发者带来了无尽的困扰，用 asp.net core 开发团队的话来说就是：我们注意到，httpclient 被很多开发人员不正确的使用。得益于 .net core 不断的版本快速升级；解决方案也一一浮出水面，本文尝试从各个业务场景去剖析 httpclient 的各种使用方式，从而在开发中正确的使用 httpclient 进行网络请求。

1.0时代发生的事情

1.1 在 1.0 时代，部署在 linux 上的 asp.net core 应用程序进程出现 “套接字资源耗尽” 的异常，该异常通常是由于不停的创建 httpclient 的实例后产生，因为每创建一个新的 httpclient 对象，将会消耗一个套接字资源，而在对象使用完成后，由于设计上的问题，即使手动释放 httpclient，也极有可能无法释放套接字资源。

1.2 思考下面的代码，在远古时代，下面的代码将会造成 “套接字资源耗尽” 的异常

        public httpclient createhttpclient()
        {
            return new httpclient();
        }

        // 或者
        public async task<string> getdata()
        {
            using (var client = new httpclient())
            {
                var data = await client.getasync("https://www.cnblogs.com");
            }

            return null;
        }

1.3 继而引出了下面的使用方法，利用静态对象进行网络请求

        private static httpclient httpclient = null;
        public httpclient createhttpclient()
        {
            if (httpclient == null)
                httpclient = new httpclient();

            return httpclient;
        }

1.4 上面使用静态对象的方式可以避免 “套接字资源耗尽” 的异常，但是，有一个致命的问题，当主机 dns 更新时，你可能会收到另外一个异常

an error occurred while sending the request. couldn't resolve host name an error occurred while sending the request. couldn't resolve host name

1.5 该异常指示无法解析主机名称，其实就是因为静态 httpclient 对象不会随着主机 dns 更新而更新，这个时候，你通常需要做的就是：重启服务！

2. 正确的使用 httpclient

2.1 时间来到了 .net core 的 2.2 时代（其实2.1就可以），官方推荐我们应该使用依赖注入的方式去使用 httpclient，比如在 startup.cs 的 configureservices 方法中加入下面的代码

        public void configureservices(iservicecollection services)
        {
            ...
            services.addhttpclient();
        }

2.2 然后再控制器中通过构造方法注入 httpclient 对象进行使用

    public class valuescontroller : controllerbase
    {
        private httpclient httpclient;
        public valuescontroller(httpclient httpclient)
        {
            this.httpclient = httpclient;
        }

        ...
    }

2.3 在新版本的 asp.net core 中，asp.net core 开发团队引入了 httpclientfactory

        public httpclient createhttpclient()
        {
            return httpclientfactory.create();
        }

2.4 httpclientfactory 的主要工作就是创建 httpclient 对象，但是在创建过程中，通过为每个 httpclient 对象创建一个单独的清理句柄来对 httpclient 进行跟踪和管理，以确保在对象使用完成后能够及时的释放网络请求的资源，也就是套接字，具体 httpclientfactory 内部原理可参考 *章-dotnetcore深入了解之三httpclientfactory类.

2.5 更重要的是，httpclientfactory 内部管理着一个连接句柄池，一旦高并发的到来，httpclientfactory 内句柄池内使用完成但是未被释放的句柄将被重新使用，虽然使用 httpclientfactory.create() 每次都是返回一个新的 httpclient 对象，但是其背后的管理句柄是可以复用的，换句话说就是 “套接字复用”，而且还不会有 dns 无法同步更新的问题

2.6 所以现在我们明白了为什么要使用 httpclientfactory 来创建 httpclient 对象

3. 使用类型化的 httpclient 客户端

3.1 在常规应用和微服务的应用场景中，都可以使用类型化的客户端，类型化客户端这个词如果不太好理解，那么你可以理解为为每个业务单独的使用一个 httpclient 客户端，比如获取天气预报，思考下面的代码

public class weatherservice
{
    private httpclient httpclient;
    public weatherservice(httpclient httpclient)
    {
        this.httpclient = httpclient;
        this.httpclient.baseaddress = new uri("http://www.weather.com.cn");
        this.httpclient.timeout = timespan.fromseconds(30);
    }

    public async task<string> getdata()
    {
        var data = await this.httpclient.getasync("/data/sk/101010100.html");
        var result = await data.content.readasstringasync();

        return result;
    }
}

3.2 为了在控制器中更好的使用 weatherservice，我们需要把 weatherservice 注入到服务中

    public void configureservices(iservicecollection services)
    {
        ...
        services.addhttpclient();
    }

    // 然后，在控制器中使用如下代码

    [route("api/[controller]")]
    [apicontroller]
    public class valuescontroller : controllerbase
    {
        private weatherservice weatherservice;
        public valuescontroller(weatherservice weatherservice)
        {
            this.weatherservice = weatherservice;
        }

        [httpget]
        public async task<actionresult> get()
        {
            string result = string.empty;
            try
            {
                result = await weatherservice.getdata();
            }
            catch { }

            return new jsonresult(new { result });
        }
    }

3.3 运行程序，你将得到 北京市 的天气

{
result: "{"weatherinfo":{"city":"北京","cityid":"101010100","temp":"27.9","wd":"南风","ws":"小于3级","sd":"28%","ap":"1002hpa","njd":"暂无实况","wse":"<3","time":"17:55","sm":"2.1","isradar":"1","radar":"jc_radar_az9010_jb"}}"
}

3.4 在微服务中，这种做法很常见，而且非常有用，通过使用类型化的客户端，除了在构造方法中注入 httpclient 外，我们还可以注入任何需要的东西到 weatherservice 中，更重要的是，可以对业务应用扩展策略，还方便了管理
3.5 在 weatherservice 类型化客户端中，虽然每次都是创建了一个新的 httpclient 对象，但是其内部的句柄和其它 httpclient 是共用同一个句柄池，无需担心

4.对 httpclient 应用策略

4.1 下面说到的策略组件是业内大名鼎鼎的 polly （波莉），github 地址：https://github.com/app-vnext/polly
4.2 使用重试策略，参考 polly 的 wiki 示例代码，使用起来非常简单

首先需要从 nuget 中引用包
polly
polly.extensions.http

4.3 接着在 startup.cs configureservices 方法中应用策略

        public void configureservices(iservicecollection services)
        {
            ...
            services.addhttpclient<weatherservice>()
                    .sethandlerlifetime(timespan.fromminutes(5))
                    .addpolicyhandler(policy =>
                    {
                        return httppolicyextensions.handletransienthttperror()
                                                   .waitandretryasync(3,
                                                   retryattempt => timespan.fromseconds(2),
                                                   (exception, timespan, retrycount, context) =>
                                                   {
                                                       console.foregroundcolor = consolecolor.yellow;
                                                       console.writeline("请求出错了：{0} | {1} ", timespan, retrycount);
                                                       console.foregroundcolor = consolecolor.gray;
                                                   });
                    });
        }

4.4 以上代码表示在请求发生错误的情况下，重试 3 次，每次 2 秒，针对高并发的请求，重试请求间隔建议使用随机值

结语

• 本章着重介绍了 httpclient 在 asp.net core 中的前世今生，简单介绍了使用原理，介绍了各种使用 httpclient 的方式
• 介绍了使用了 polly 对在类型化的客户端上使用 httpclient 重试策略，因为对 polly 理解不够，其它的策略就不再介绍，大家可以到 polly 的 wiki 上深入了解
• 最后通过一个简单的获取天气预报的小实例来演示类型化的客户端使用场景

示例代码下载

https://files.cnblogs.com/files/viter/ron.httpclientdemo.zip