同步操作加超时：用 Task.Run
包裹 + Wait
带超时参数
同步方法本身不支持直接设超时，硬等可能卡死线程。常见做法是把同步逻辑扔进
Task.Run，再用
Wait(TimeSpan)控制等待时长。
注意：
Task.Run只是把同步代码挪到线程池执行，并不会自动中断原操作——超时后只是放弃等待，后台线程仍会继续跑完（除非你手动加取消逻辑）。 适合短时、无副作用、可容忍“超时后仍执行完”的场景 别在 UI 线程调用
Wait，容易死锁；服务端或控制台可用 超时返回
false，需主动检查，不能只靠异常
var task = Task.Run(() => HeavySyncWork());
if (!task.Wait(TimeSpan.FromSeconds(3)))
{
Console.WriteLine("超时，但任务仍在后台运行");
}
else
{
var result = task.Result;
}
异步操作加超时：优先用 WaitAsync
或 WithCancellation
组合
.NET 6+ 推荐用
Task.WaitAsync(CancellationToken)，它真正支持协作式取消——前提是被等待的异步操作内部响应
CancellationToken。
如果目标方法（如
HttpClient.GetAsync）本身就接受
CancellationToken，直接传入即可；否则只能靠外层
WaitAsync放弃等待，无法中止实际 I/O。
WaitAsync是推荐方式，比
Task.Delay+
Task.WhenAny更简洁、语义更清晰 务必确保下游异步方法真的检查了 token，否则超时只是“假装取消” 不要用
Task.TimeoutAfter（已废弃），它在 .NET 5+ 中移除
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
try
{
var result = await SomeAsyncMethod(cts.Token);
}
catch (OperationCanceledException) when (cts.IsCancellationRequested)
{
Console.WriteLine("异步操作被超时取消");
}
HttpClient 请求超时：别只信 Timeout
属性
HttpClient.Timeout只控制整个请求的**总耗时**，且仅作用于单个
SendAsync调用——它不包括 DNS 解析、连接建立、TLS 握手等前置阶段，这些可能单独卡住十几秒。
更稳的做法是：设置较短的
Timeout+ 外层加
CancellationToken，并确保
HttpClient实例复用（避免新建实例导致连接池失效）。
Timeout设为
TimeSpan.FromSeconds(10)是常见起点，太短易误杀，太长失去意义 DNS 或 TCP 连接超时需靠操作系统或自定义
Socket层控制，.NET 不暴露直接接口 若用
HttpClientHandler，可设
MaxConnectionsPerServer防连接耗尽
自定义可取消同步操作：用 CancellationToken.Register
触发清理
当必须写一个“能被超时中断”的同步方法时，不能依赖线程中止（已禁用且不安全），得靠协作式取消：在关键阻塞点轮询
IsCancellationRequested，或用
Register绑定清理动作。
比如文件读取循环、重试逻辑、或调用第三方 SDK 的阻塞 API 时，提前注册取消回调，确保资源释放。
别在Register里做耗时操作，否则拖慢取消响应 轮询
IsCancellationRequested要轻量，避免影响主逻辑性能 超时不是万能的——有些系统调用（如
Console.ReadLine）根本不响应 token
void SyncWorkWithCancellation(CancellationToken ct)
{
ct.Register(() => Console.WriteLine("收到取消信号，准备退出"));
for (int i = 0; i < 100; i++)
{
if (ct.IsCancellationRequested) break;
Thread.Sleep(100);
}
}
超时逻辑最常被忽略的，是“取消是否真正生效”——光抛出 OperationCanceledException不代表操作停了，得看它到底在哪个环节响应 token。
