Go中请求上下文管理通过context包实现，核心是context.Context传递截止时间、取消信号和键值对，专用于单次请求生命周期；需用WithTimeout/WithCancel控制超时与主动取消，显式传递并监听Done()，配合资源清理确保健壮性。
在 Go 中，请求上下文管理主要通过 context 包实现，核心是用 context.Context 传递截止时间、取消信号和请求作用域的键值对。它不是为全局状态设计的，而是为单次请求生命周期服务——比如 HTTP 处理、数据库查询或 RPC 调用。
用 context.WithTimeout 控制请求超时
当一个操作（如调用下游 API 或执行 SQL 查询）不能无限等待时，应显式设置超时。使用 context.WithTimeout 可创建带截止时间的子上下文，底层自动触发 Done() channel 关闭。
- 传入父 context（通常是
req.Context()）和期望持续时间，返回新 context 和 cancel 函数 - 务必调用
cancel()（通常用defer），避免 goroutine 泄漏和 timer 持续占用资源 - 被包装的操作需主动监听
ctx.Done()并响应ctx.Err()（如context.DeadlineExceeded）
示例：
ctx, cancel := context.WithTimeout(r.Context(), 5*time.Second)
defer cancel()
<p>result, err := db.QueryContext(ctx, "SELECT * FROM users WHERE id = ?", userID)
if err != nil {
if errors.Is(err, context.DeadlineExceeded) {
http.Error(w, "Request timeout", http.StatusGatewayTimeout)
return
}
http.Error(w, "DB error", http.StatusInternalServerError)
return
}用 context.WithCancel 主动终止请求链
某些场景下，外部条件变化（如用户关闭页面、前端取消请求、配置变更）需要立即中断正在进行的操作。这时用 context.WithCancel 创建可手动取消的上下文。
立即学习“go语言免费学习笔记（深入）”；
搜索商品、准备购物车、发布 UCP 个人资料，并通过 The Agent Times UCP Gateway 创建买家确认的商家结账流程。UCP Gateway 是面向支持 UCP 的电商平台构建的购物基础设施层，其核心为 Universal Commerce Protocol（通用商业协议）。
- 适合与信号、事件或状态变更联动，比如收到 SIGINT 后批量取消所有活跃请求
- 注意：取消是“建议式”的，下游函数必须检查
ctx.Err()并及时退出，否则 cancel 不生效 - 不要跨 goroutine 复用同一个 cancel 函数；每个请求应有独立的 cancel 生命周期
常见误用：在 handler 中直接调用 cancel() 而不等待子任务结束，导致部分逻辑未清理。建议配合 sync.WaitGroup 或 errgroup.Group 协作退出。
向下传递 context 并正确注入依赖
HTTP handler 接收的 *http.Request 已携带 context，但该 context 仅用于请求生命周期。若需向数据库、缓存、日志等组件传递控制权，必须显式传入并使用支持 context 的方法（如 QueryContext、DoContext）。
- 避免把 context 存在结构体字段中长期持有；它是一次性的，过期即失效
- 不要用
context.Background()替代请求 context，否则丢失超时和取消能力 - 如需附加请求级数据（如 traceID、userID），用
context.WithValue，但只传不可变、少量、明确语义的值；避免传 struct 或复杂对象
例如注入 trace ID：
ctx = context.WithValue(r.Context(), "trace_id", uuid.New().String()) // 后续日志、HTTP header、DB 注释都可从中提取
处理 context 取消后的资源清理
context 取消本身不释放内存或关闭连接，只是发出信号。真正健壮的实现必须在收到 ctx.Done() 后做清理：关闭文件、释放锁、终止 goroutine、归还连接池。
- 在 defer 中检查
ctx.Err()判断是否因取消退出，决定是否记录 warn 日志 - 使用
select监听ctx.Done()和业务 channel，确保任一完成即退出 - 第三方库（如
sql.DB、net/http.Client）大多已适配 context，优先选用XXXContext方法而非旧版
典型 select 模式：
select {
case <-ctx.Done():
log.Warn("operation cancelled:", ctx.Err())
return ctx.Err()
case result := <-slowOperationChan:
return result
} 
