Deadline 是客户端设定的 UTC 绝对截止时间，CancellationToken 是服务端据此自动生成的只读取消信号；二者角色分离、协同工作，缺一不可。
Deadline 和 CancellationToken 不是同一个东西，但它们在 gRPC 调用中紧密协作——Deadline 是客户端设定的“绝对截止时刻”，CancellationToken 是服务端用来响应这个时刻的“取消信号载体”。
Deadline 是什么？为什么必须显式设置
gRPC 的 CallOptions.Deadline 是一个 DateTime 类型的 UTC 时间点（不是 TimeSpan），它随请求一起发给服务端。客户端和服务端各自独立检查是否超时：客户端在到达该时间点后立即中断 HTTP/2 流并抛出 RpcException（StatusCode.DeadlineExceeded）；服务端则通过 ServerCallContext.CancellationToken 感知取消信号。
- 没有默认值：不设
deadline就等于无限等待，极易拖垮服务资源 - 过去或当前时间会立刻触发超时：比如
DateTime.UtcNow或DateTime.Now（非 UTC）都不可靠 - 服务端无法“修改” Deadline：它只是接收并响应，不能延长或重置
CancellationToken 怎么从 Deadline 生成出来
服务端的 ServerCallContext.CancellationToken 并非手动创建，而是由 gRPC 框架根据客户端传来的 Deadline 自动绑定生成的。你不需要、也不应该用 CancellationTokenSource 手动创建它来覆盖这个 token。
- 它本质是“只读”的取消信号源，背后关联着 Deadline 倒计时器
- 你在服务方法中直接使用
context.CancellationToken即可，例如传给DbContext.FindAsync(..., ct)、HttpClient.GetAsync(..., ct)等异步 API - 如果忽略它（比如写
await _db.Users.ToListAsync()而不传 token），即使 Deadline 已到，数据库查询仍会继续跑完，造成资源浪费
常见错误：混用 CancellationTokenSource 和 Deadline
有人试图在客户端用 CancellationTokenSource 控制调用，再额外加 deadline，结果行为不可预测——因为两者触发逻辑不同，且可能互相干扰。
- 客户端主动取消（
cts.Cancel()）会提前终止调用，但不会影响服务端的 Deadline 计时 - Deadline 超时会触发服务端的
context.CancellationToken，但不会触发你自建的CancellationTokenSource - 推荐做法：客户端只用
deadline；服务端只用context.CancellationToken；避免自己 newCancellationTokenSource去包装或桥接
var client = new Greeter.GreeterClient(channel);
try
{
var response = await client.SayHelloAsync(
new HelloRequest { Name = "World" },
deadline: DateTime.UtcNow.AddSeconds(5)); // ✅ 正确：只设 deadline
}
catch (RpcException ex) when (ex.StatusCode == StatusCode.DeadlineExceeded)
{
Console.WriteLine("Greeting timeout.");
}
// 服务端实现
public override async Task<HelloReply> SayHello(HelloRequest request, ServerCallContext context)
{
// ✅ 正确：直接用 context.CancellationToken
var user = await _databaseContext.Users.FindAsync(request.Name, context.CancellationToken);
return new HelloReply { Message = "Hello " + user?.Name };
}
最常被忽略的一点是：Deadline 是跨网络传递的语义，而 CancellationToken 是服务端内部响应这个语义的机制——它们是一体两面，但角色严格分离。写错任意一端，就等于让超时控制形同虚设。
