17370845950

Go Web 服务中应为每个 HTTP 请求创建带超时的 context，避免复用全局 context；在 handler 入口或中间件中使用 context.WithTimeout 派生新 context，并透传至 DB、HTTP 等所有阻塞操作。

在 Go Web 服务中，context.Context 是控制请求生命周期、传播取消信号和传递超时的核心机制。合理使用 context 能显著降低因长等待、资源未释放或 goroutine 泄漏带来的性能开销，尤其在高并发、链路调用深的场景下效果明显。

为每个 HTTP 请求创建带超时的 context

不要复用全局或长期存活的 context；应在 handler 入口立即派生新 context，并设置合理的截止时间。超时值应略大于下游依赖（如 DB、RPC）的预期耗时，避免过早中断，也防止无限等待。

• 用 context.WithTimeout(ctx, 5*time.Second) 替代无限制的 context.Background()
• 若需统一超时策略，可在中间件中注入，例如：r.Use(func(h http.Handler) http.Handler { return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { ctx, cancel := context.WithTimeout(r.Context(), 3*time.Second); defer cancel(); r = r.WithContext(ctx); h.ServeHTTP(w, r) }) })
• 注意：超时后，ctx.Err() 返回 context.DeadlineExceeded，下游函数应检查并快速退出

将 context 透传到所有阻塞操作中

任何可能挂起的调用——数据库查询、HTTP 客户端请求、channel 接收、锁等待——都应接受 context 并响应取消。标准库（如 net/http.Client、database/sql）已原生支持 context；自定义函数也需显式接收并监听。

• HTTP 请求示例：resp, err := http.DefaultClient.Do(req.WithContext(ctx))
• SQL 查询示例：rows, err := db.QueryContext(ctx, "SELECT ...")
• 自定义函数需主动轮询：select { case
• 避免在 goroutine 中忽略 context：启动子 goroutine 时务必传入派生 context，并在退出前调用 cancel()（若需）

避免 context 取消后的资源泄漏

context 取消仅发送信号，不自动释放文件句柄、连接、goroutine 等资源。必须在业务逻辑中显式清理，否则会持续占用内存或连接数。

• 使用 defer cancel() 配合 WithTimeout 或 WithCancel，确保无论成功失败都释放 cancel 函数
• 对数据库连接、HTTP 响应体等，用 defer resp.Body.Close() 或 defer rows.Close()，且这些操作应在 context 取消后仍能安全执行
• 若启动了后台 goroutine 处理异步任务，应在 ctx.Done() 触发时退出循环并关闭相关 channel

慎用 context.WithValue 传递业务数据

WithValue 仅适合传递请求范围的元数据（如 traceID、用户身份），不应替代函数参数传递核心业务字段。过度使用会增加隐式依赖，降低可读性与可测性，也带来额外分配开销。

• 推荐做法：handler 解析必要参数后，作为普通参数传给业务函数
• 若必须用 WithValue，请定义明确的 key 类型（如 type userIDKey struct{}），避免字符串 key 冲突
• 注意：value 不参与 cancel/timeout 控制，纯属“附带信息”，勿用于控制流程分支