延迟加载函数必须接收 context.Context 参数；否则无法响应超时控制，常见错误是闭包中使用 context.Background() 或忽略 ctx，正确做法是函数签名显式包含 ctx 并监听 ctx.Done()。
延迟加载函数必须接收 context.Context 参数
不把 ctx 传进延迟加载逻辑，就等于没接上超时控制的“信号缆绳”。常见错误是写一个闭包或匿名函数启动延迟任务，但里面用的是 context.Background() 或直接忽略 ctx，导致外层超时后任务仍在运行。
正确做法是：所有延迟执行的函数签名必须显式包含 ctx context.Context，并在内部监听 ctx.Done()。比如：
func loadUserAsync(ctx context.Context, id int) <-chan User {
ch := make(chan User, 1)
go func() {
select {
case <-time.After(3 * time.Second): // 模拟延迟加载
ch <- User{ID: id, Name: "alice"}
case <-ctx.Done(): // 关键：响应取消
return
}
}()
return ch
}- 不能把
time.After当作超时控制主力——它和ctx无关，无法被父级取消中断 - 延迟加载若涉及 I/O（如 DB 查询、HTTP 调用），应优先使用支持
Context的 API，例如db.QueryRowContext(ctx, ...)，而非db.QueryRow(...) - 如果延迟逻辑里用了
time.Sleep，必须配合select+ctx.Done()，不能只靠 sleep 后再检查ctx.Err()
WithDeadline 比 WithTimeout 更适合固定延迟场景
当你的延迟加载有明确截止时间点（比如“必须在 2026-10-16T20:00:00Z 前完成”），用 context.WithDeadline 更可靠。因为 WithTimeout 是从调用时刻起算相对时长，在高负载、GC 卡顿或调度延迟下，实际触发时间可能漂移 1~2 秒；而 WithDeadline 直接比对系统时间，只要 NTP 同步正常，精度更高。
示例：
立即学习“go语言免费学习笔记（深入）”；
deadline := time.Date(2026, 10, 16, 20, 0, 0, 0, time.UTC) ctx, cancel := context.WithDeadline(parentCtx, deadline) defer cancel() <p>userCh := loadUserAsync(ctx, 123)
- 传入已过期的
deadline会立即触发取消，ctx.Err()返回context.DeadlineExceeded - 不要手动计算剩余时间再套
WithTimeout——这会丢失原始Done()通道，且无法响应父级提前取消 - 若需在延迟加载中嵌套其他子任务（如先查缓存、再查 DB），应将同一
ctx向下传递，确保整条链路共享同一个取消源
延迟加载返回 channel 时，Done() 关闭后要清空接收端
用 chan 接收延迟结果很常见，但如果只监听 ctx.Done() 就退出，而 channel 中已有值未读取，会导致发送 goroutine 永久阻塞（因缓冲区满或无接收者）。
安全模式是：在 select 中同时监听结果 channel 和 ctx.Done()，且对已发送但未消费的值做兜底处理：
func safeLoad(ctx context.Context, id int) (User, error) {
ch := loadUserAsync(ctx, id)
select {
case u := <-ch:
return u, nil
case <-ctx.Done():
// 防止 ch 发送端卡住：尝试非阻塞接收一次
select {
case u := <-ch:
return u, nil
default:
}
return User{}, ctx.Err()
}
}- 不要假设
loadUserAsync一定只发一个值——万一它重试了多次，channel 可能有多个待读值 - 若使用无缓冲 channel，必须确保至少有一个 goroutine 在接收，否则第一次 send 就死锁
- 更稳妥的做法是让延迟加载函数自己管理 channel 生命周期，比如返回
func() (User, error)而非 channel，避免跨 goroutine 通信复杂度
延迟加载 + context 最容易被忽略的泄漏点
真正线上出问题的，往往不是“没传 context”，而是“传了但没用对”。典型泄漏场景包括：
- 在延迟加载中启动新 goroutine（比如日志上报、指标打点），但没把
ctx传进去，也没做超时保护，这些 goroutine 会长期存活 - 用
time.AfterFunc实现延迟，却没检查ctx.Err()—— 它无法感知父 context 取消，timer 会照常触发 - 把
ctx存进结构体字段或全局 map，造成 context 泄漏（尤其带WithValue时，会阻止 GC 回收关联数据） - 延迟加载函数内调用了不支持 context 的旧库（如某些老版本 redis client），又没手动加
select判断，等于断开了信号链
判断是否泄漏的最简单方式：在延迟函数开头打印 fmt.Printf("start with deadline: %v\n", ctx.Deadline())，上线后观察日志里是否有大量 “start with deadline: 0001-01-01…” —— 这说明传入的是 context.Background() 或未设置 deadline 的 context。
