在使用 HttpClient 发送 HTTP 请求时，合理设置超时时间非常重要。它能避免请求长时间挂起，影响应用性能甚至导致资源耗尽。.NET 中的 HttpClient.Timeout 属性是控制整个请求生命周期的最大等待时间的关键配置。
理解 HttpClient.Timeout 的作用
Timeout 属性用于设置从发送请求开始到接收到完整响应为止的最长等待时间。一旦超过设定的时间，就会抛出 TaskCanceledException 异常，并提示“The operation was canceled because it exceeded the configured timeout.”
默认情况下，Timeout 为 100 秒。你可以根据实际网络环境和业务需求调整这个值。
设置超时时间的基本方法
创建 HttpClient 实例时，可以通过设置其 Timeout 属性来定义超时时间：
使用 TimeSpan 类型赋值，例如设置为 30 秒：var client = new HttpClient();
client.Timeout = TimeSpan.FromSeconds(30);
client.Timeout = TimeSpan.FromMilliseconds(5000); // 5秒
若希望禁用超时（不推荐生产环境），可设为 Timeout.InfiniteTimeSpan：client.Timeout = Timeout.InfiniteTimeSpan;
注意连接与读取阶段的超时限制
HttpClient.Timeout 控制的是整个请求过程，包括 DNS 解析、建立连接、发送数据、等待响应和接收响应体。但它无法单独控制连接超时或读取超时。
如果你需要更细粒度的控制（比如连接阶段最多等 5 秒），.NET 原生的 HttpClient 不支持直接设置连接超时。此时可以考虑以下方案：
使用 CancellationToken 配合 CancelAfter 实现灵活超时控制：var cts = new CancellationTokenSource();
cts.CancelAfter(TimeSpan.FromSeconds(10)); // 10秒后取消
try {
var response = await client.GetAsync("https://api.example.com", cts.Token);
} catch (OperationCanceledException) {
// 超时或取消处理
}
这种方式适用于需要动态控制不同请求的超时策略，尤其适合并行请求或第三方 API 响应不稳定的情况。
使用 IHttpClientFactory 管理超时（推荐方式）
在 ASP.NET Core 或依赖注入场景中，建议通过 IHttpClientFactory 创建客户端，并结合命名客户端或类型化客户端设置超时。
虽然不能直接在工厂配置中设置超时（因为 HttpClient 实例由工厂管理），但可以在创建时自定义 HttpMessageHandler：
services.AddHttpClient("with-timeout", client =>
{
client.Timeout = TimeSpan.FromSeconds(20);
});
这样每次通过工厂获取名为 "with-timeout" 的客户端时，都会使用预设的超时配置。
基本上就这些。掌握 Timeout 设置和 CancellationToken 的配合使用，能有效提升服务的健壮性和响应能力。关键在于根据实际场景平衡等待时间和用户体验，避免无限等待。
