本文告诉大家如何在 dotnet 6 下使用 HttpClient 更加精细的控制网络请求的超时,实现 HttpWebRequest 的 ReadWriteTimeout 功能
本文将介绍如何在 HttpClient 控制以下网络行为的超时
- 网络连接超时
- 网络请求超时
- 网络响应超时
- 网络总超时
在 dotnet 6 下 HttpClient 只是一个包装类,实际的网络请求的核心实现是通过 SocketsHttpHandler 实现的,详细请看 dotnet 6 HttpClientHandler 和 SocketsHttpHandler 有什么差别 - lindexi - 博客园
在 HttpClient 里,由于 HttpClient 自带的 Timeout 碰触不到底层网络,导致了 Timeout 属性控制范围太广,很多业务上都不合适使用,比如做大文件上传,自然在上传过程中就超时了,如果用户的网络上传速度不快。在 HttpClient 里面,设置 Timeout 表示设置整个网络请求过程的总超时时间。如果只是期望设置连接超时,那自然是做不到的
既然实际的网络是 SocketsHttpHandler 实现的,在 SocketsHttpHandler 可以进行更加精细的控制,例如通过 ConnectTimeout 属性即可用来控制连接的超时时间
代码语言:javascript复制 var handler = new SocketsHttpHandler()
{
ConnectTimeout = TimeSpan.FromSeconds(10),
};
var client = new HttpClient(handler);
这里值得敲黑板的是在 dotnet 6 下,将会大量的复用连接,也就是如果不逗比的情况下,多次对相同的链接请求,在时间距离不远的前提下,是可以复用连接的,不需要做重复的连接。特别是在设置 SocketsHttpHandler 的 EnableMultipleHttp2Connections 为 true 再加上服务器端也支持 Http 2 的多路复用情况下
如果是想和 HttpWebRequest 一样控制 ReadWriteTimeout 的时间,在 dotnet 6 下,可以对请求和响应,也就是发送和接收做分别的超时控制,这就是用到了 dotnet 6 新的 ConnectCallback 属性实现,例子代码如下
代码语言:javascript复制 handler.ConnectCallback = async (context, cancellationToken) =>
{
var socket = new Socket(SocketType.Stream, ProtocolType.Tcp);
try
{
socket.NoDelay = true;
// 这里可以自己偷偷改掉域名哦,也就是将原本请求的域名修改为一个奇怪的域名。这里偷偷改了,团队的其他伙伴可是很难调试出来的哦
await socket.ConnectAsync(context.DnsEndPoint, cancellationToken)
// 配置异步等待后不需要回到原来的线程
.ConfigureAwait(false);
// 发送的超时时间,相当于请求的超时
socket.SendTimeout = (int) TimeSpan.FromSeconds(10).TotalMilliseconds;
// 接收的超时时间,相当于响应的超时
socket.ReceiveTimeout = (int) TimeSpan.FromSeconds(5).TotalMilliseconds;
}
catch
{
socket.Dispose();
throw;
}
// 在 NetworkStream 里,设置 ownsSocket 参数为 true 将会在 NetworkStream 被释放的时候,自动释放 Socket 资源
return new NetworkStream(socket, ownsSocket: true);
};
可以看到 HttpClient 的控制是比 HttpWebRequest 更强的,可以分别控制请求和响应的超时
另外,这里的 ConnectCallback 也如上文描述,由于 HttpClient 将会尽可能复用连接,不一定每次请求都会进来,建议不要将配置作为动态配置,想要根据业务动态决定超时时间是不靠谱的行为,这里应该是初始化过程,给定准确的值
回顾一下,控制网络总超时,使用 HttpClient 自带的 Timeout 属性
控制网络的连接超时,使用 SocketsHttpHandler 的 ConnectTimeout 属性
控制网络的请求超时,使用 Socket 的 SendTimeout 属性
控制网络的响应超时,使用 Socket 的 ReceiveTimeout 属性
更多请参阅 dotnet 6 使用 HttpClient 的超时机制