Go 中 context 必须显式传递,所有函数需接收 ctx 参数并逐层透传,HTTP middleware 是统一注入 context 和 logger 的最佳位置,goroutine 启动前须派生带 cancel 的子 context。

Context传递必须显式传参,不能依赖全局变量
Go 的 context.Context 不会自动跨 goroutine 或函数调用链传播,必须作为第一个参数显式传入。很多人误以为在 HTTP handler 里用了 ctx := r.Context(),后续调用的子函数就能“自动拿到”,结果日志里全是空 trace ID 或超时未生效。
常见错误是写成这样:
func handleRequest(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
doSomething() // ❌ 没传 ctx,内部无法感知取消或携带值
}
正确做法是逐层透传:
- 所有中间函数签名必须接收
ctx context.Context参数 - 调用下游时用
context.WithValue()或context.WithTimeout()衍生新上下文,再传下去 - 避免在工具函数(如 DB 查询、HTTP client 调用)里硬编码
context.Background()
日志记录需绑定 context.Value 中的 traceID 和 requestID
单纯用 log.Printf 或第三方 logger(如 zerolog、zap)打日志,无法关联请求生命周期。必须从 ctx 中提取标识符,并注入 logger 实例。
典型场景:HTTP 请求进来时生成 requestID,存入 ctx,后续所有日志都带上它:
reqID := uuid.New().String()
ctx = context.WithValue(r.Context(), "requestID", reqID)
logger := zerolog.Ctx(ctx).With().Str("request_id", reqID).Logger()
注意点:
- 不要用字符串字面量做
context.Value的 key(如"requestID"),应定义为私有类型避免冲突:type ctxKey string; const requestIDKey ctxKey = "requestID" -
zerolog.Ctx(ctx)仅在使用zerolog且已调用zerolog.Contextual()初始化时才有效;zap需手动用ctx.Value()提取后调用With() - 如果中间某层忘了传
ctx,下游zerolog.Ctx(ctx)会 fallback 到 root logger,丢失字段
HTTP middleware 是统一注入 context 和 logger 的最佳位置
在 handler 外围用 middleware 补全 context 和 logger,比每个 handler 里重复写更可靠。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
示例(基于 net/http):
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
reqID := r.Header.Get("X-Request-ID")
if reqID == "" {
reqID = uuid.New().String()
}
ctx := context.WithValue(r.Context(), requestIDKey, reqID)
r = r.WithContext(ctx)
logger := zerolog.Ctx(ctx).With().
Str("method", r.Method).
Str("path", r.URL.Path).
Str("request_id", reqID).
Logger()
// 把 logger 注入 context(供下游用)
ctx = logger.WithContext(ctx)
// 替换原 request 的 context
r = r.WithContext(ctx)
// 记录开始时间、调用 next、记录耗时
start := time.Now()
next.ServeHTTP(w, r)
logger.Info().Dur("duration", time.Since(start)).Msg("request finished")
})
}
关键细节:
- 必须用
r.WithContext()创建新*http.Request,原对象不可变 - 把 logger 实例也塞进 context(
logger.WithContext(ctx)),下游可直接用zerolog.Ctx(ctx)获取带字段的 logger - 别在 middleware 里直接调用
log.Printf—— 它不感知 context,字段会丢失
goroutine 启动前必须派生带 cancel 的子 context
在 handler 内起 goroutine 时,若直接传入原始 ctx,父请求结束(如客户端断开)时 goroutine 无法收到取消信号,可能造成资源泄漏或重复日志。
正确方式是用 context.WithCancel() 或 context.WithTimeout() 派生:
go func() {
childCtx, cancel := context.WithTimeout(ctx, 5*time.Second)
defer cancel() // 防止 goroutine 泄漏
result := heavyWork(childCtx) // heavyWork 内部需 select ctx.Done()
logger := zerolog.Ctx(childCtx)
logger.Info().Interface("result", result).Msg("work done")
}()
容易忽略的点:
- 忘记调用
cancel()—— 即使超时触发了childCtx.Done(),不显式 cancel 仍会泄漏 goroutine 相关资源 -
heavyWork函数没检查ctx.Done(),导致超时后仍在执行,日志里出现 “work done” 但实际已无效 - 子 goroutine 中又起了新 goroutine,却继续传
childCtx而非再次派生,取消链断裂
context 与日志的耦合点不在语法层面,而在调用链的每一步是否主动维护——少一次 WithContext,就断一次 trace;漏一个 ctx.Value() 提取,日志就失去上下文。最麻烦的不是写法,而是团队里有人偷偷绕过 middleware 直接 new Request 或硬编码 logger。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










