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。