C#的TimeoutException是什么？如何设置超时处理？

C#中的TimeoutException是程序等待外部依赖（如网络、数据库等）响应时，因超出预设时间限制而抛出的异常，旨在避免资源无限占用并提升系统健壮性。 以下是详细说明及超时处理方案：

• 外部依赖未及时响应：如网络请求、数据库查询、文件I/O等操作因服务不可用、高延迟或负载过高未在预期时间内完成。
• 任务执行超时：自定义计算任务或长时间运行的操作未设置取消机制，导致无限阻塞。

1. 网络请求与外部API调用

   使用HttpClient调用远程服务时，因对方服务性能瓶颈或网络延迟导致超时。

2. 数据库操作

   慢查询、死锁、数据库服务器负载过高或网络延迟引发SqlCommand.CommandTimeout异常。

3. 文件I/O

   访问网络共享文件、处理大文件或磁盘性能差时，读写操作超时。

4. 进程间通信（IPC）或消息队列

   通过命名管道、RabbitMQ等通信时，对方处理过慢或队列拥堵导致超时。

5. 自定义长时间任务

   Task.Run中的复杂计算未设置取消机制，可能因死循环或计算量超预期而超时。

• 设置Timeout属性：直接为HttpClient实例配置超时时间。var client = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
• 异常处理：超时可能抛出TaskCanceledException（.NET 5+可能直接抛出TimeoutException），需捕获并处理。

• 通用取消机制：通过CancellationTokenSource设置超时，传递令牌至异步操作。public async Task PerformOperationWithTimeout(TimeSpan timeout) { using (var cts = new CancellationTokenSource(timeout)) { try { await Task.Delay(TimeSpan.FromSeconds(10), cts.Token); // 模拟耗时操作 } catch (OperationCanceledException ex) when (cts.IsCancellationRequested) { throw new TimeoutException($"Operation timed out after {timeout.TotalSeconds} seconds.", ex); } }}

• 任务赛跑机制：让主任务与延时任务竞争，超时后取消主任务。public async Task<T> RaceWithTimeout<T>(Func<CancellationToken, Task<T>> operation, TimeSpan timeout) { using (var cts = new CancellationTokenSource()) { var task = operation(cts.Token); var timeoutTask = Task.Delay(timeout, cts.Token); var completedTask = await Task.WhenAny(task, timeoutTask); if (completedTask == timeoutTask) { cts.Cancel(); // 取消主任务 throw new TimeoutException($"Operation timed out after {timeout.TotalSeconds} seconds."); } else { cts.Cancel(); // 取消延时任务 return await task; // 返回主任务结果 } }}

• 数据库操作：配置SqlCommand.CommandTimeout（单位：秒）。using (var command = new SqlCommand("SELECT * FROM LargeTable", connection)) { command.CommandTimeout = 60; // 设置60秒超时 // 执行命令...}
• TCP连接：设置TcpClient.SendTimeout和ReceiveTimeout。

1. 全局默认值与局部精细化控制

   全局设置合理默认值（如HttpClient默认30秒），局部场景（如复杂报表生成）覆盖更长超时。

2. 用户体验

   根据用户容忍度设置超时（如Web页面加载≤5秒），超时后提供友好错误或重试选项。

3. 资源管理

   避免超时过长导致线程、内存耗尽，通过超时释放资源或优雅降级（如返回缓存数据）。

4. 重试机制

   结合指数退避重试偶发性超时（如网络抖动），但需限制最大重试次数。

5. 监控与告警

   收集超时频率、原因等数据，设置阈值告警以优化配置。

6. 错误处理粒度

   记录异常日志，根据业务场景决定是否向上层抛出友好异常。

超时设置是动态调整过程，需持续监控系统表现并优化配置。合理超时策略不仅能提升系统稳定性，还能优化资源利用和用户体验，是架构设计中不可或缺的风险管理环节。