Go contextdeadline 如何限定取消传播

我在排查一条“请求已经超时，但下游查询还在跑”的调用链时，发现问题通常不在 deadline 数值，而在取消信号没有沿着同一个 context.Context 传下去。Go 里的截止时间是一个可传播的约束：子 context 的 deadline 只能早于或等于父 context，父 context 先取消时，子 context 也会收到取消；但它不会强行杀掉没有监听 Done() 的 goroutine。

用 context.WithDeadline 限定一段业务的最晚结束时间，把返回的 context 传给每个支持取消的下游调用，并始终调用 cancel 释放计时器和关联资源。取消是协作协议，不是线程终止指令。

官方文档：https://pkg.go.dev/context

一个截止时间如何沿调用链收紧

WithDeadline(parent, d) 返回一个子 context。若父 context 已有更早的 deadline，新的子 context 不会把它延后；真正生效的边界仍是父级更早的时间。可以把请求入口的 deadline 当作总预算，再给单次下游调用设置更短的局部预算。

func loadProfile(parent context.Context, id string) (Profile, error) {
	// 子调用最多使用 800 毫秒，父请求更早结束时仍以父请求为准。
	deadline := time.Now().Add(800 * time.Millisecond)
	ctx, cancel := context.WithDeadline(parent, deadline)
	defer cancel() // 调用结束就释放计时器和关联资源。

	var profile Profile
	if err := queryProfile(ctx, id, &profile); err != nil {
		// DeadlineExceeded 表示时间预算耗尽，Canceled 还可能来自上游主动取消。
		return Profile{}, err
	}
	return profile, nil
}

这里的关键不是把 time.Now() 写得多精确，而是不要用 context.Background() 把上游边界截断。服务函数应接收调用方传入的 context，并把它交给 QueryContext、NewRequestWithContext 或其他支持 context 的 API。

取消传播到底能到哪里

子 context 的 Done() 会在三种情况之一发生时关闭：自己的 deadline 到期、调用自己的 cancel，或者父 context 的 Done() 关闭。关闭是信号，业务代码要主动选择它：

func queryProfile(ctx context.Context, id string, dst *Profile) error {
	// 把 ctx 交给真正的 I/O，让驱动有机会停止等待。
	rows, err := db.QueryContext(ctx, `SELECT name FROM profiles WHERE id = ?`, id)
	if err != nil {
		return err
	}
	defer rows.Close() // 无论成功、超时还是主动取消，都关闭结果集。

	select {
	case 

如果自定义工作没有监听 Done()，它不会因为 deadline 到期自动消失；如果下游 API 接受 context 却没有使用它，传播也只停留在函数参数层。另一个常见误区是“子取消会取消父”：实际上 cancel() 只影响当前子树，不会回头取消父 context 或兄弟分支。

生产代码里怎样留出可控的收尾时间

截止时间应服务于资源预算，而不是成为一个到点就“杀线程”的错觉。通常在入口保留总 deadline，在每个下游调用前检查 Deadline()，只在确有必要时创建更短的子 deadline。取消后要关闭 rows、响应体、文件或自定义通道；如果必须完成很短的审计写入，应明确它是否允许脱离原 context，不能偷偷用背景 context 无限延长请求。

排查时可以按这个顺序判断：

1. 先看 ctx.Deadline() 是否存在，以及剩余时间是否已经不足。
2. 再看下游函数签名和实际 API 是否真的接收并使用该 context。
3. 错误处理区分 context.DeadlineExceeded、context.Canceled 与驱动自身错误。
4. 最后确认取消路径是否关闭资源；cancel 不等待 goroutine 退出，必要时另设完成信号。

几个容易混淆的边界

WithTimeout 和 WithDeadline 有什么区别？

WithTimeout 是“从现在起持续一段时间”的写法，本质上可表达为相对当前时间计算 deadline；WithDeadline 直接使用绝对时间。跨多层调用时，绝对截止时间更适合共享同一份剩余预算。

deadline 到期后还能继续读结果吗？

不应把到期当成结果可用。先检查返回错误和 ctx.Err()，只有明确完成且数据完整时才交给上层；到期后的迟到结果不能覆盖已经取消的请求状态。

为什么调用 cancel 后 goroutine 还在？

CancelFunc 只广播取消并释放 context 资源，不等待工作停止。goroutine 必须在循环、阻塞点或 I/O 调用中观察 Done()，并配合 WaitGroup、完成 channel 等机制收尾。