使用zap实现结构化日志与请求追踪，通过中间件生成trace_id并注入context，结合自定义ResponseWriter记录状态码，确保日志携带trace_id实现请求链路串联，提升系统可观测性。
在Go语言构建的Web服务中，日志记录和请求追踪是保障系统可观测性的重要手段。良好的日志体系不仅能帮助开发者快速定位问题，还能为性能分析和用户行为追踪提供数据支持。本文介绍如何在Golang Web应用中实现结构化日志记录与请求级别的追踪。
使用结构化日志记录
标准库log包输出的是纯文本日志，不利于后期分析。推荐使用uber-go/zap或rs/zerolog等高性能结构化日志库。
以zap为例：
- 安装： go get go.uber.org/zap
- 初始化Logger：
var logger *zap.Logger
func init() {
var err error
logger, err = zap.NewProduction()
if err != nil {
panic(err)
}
}
结构化日志能自动记录时间、级别、调用位置，并以键值对形式输出上下文信息，便于ELK等系统解析。
立即学习“go语言免费学习笔记（深入）”；
中间件实现请求追踪
通过HTTP中间件为每个请求生成唯一追踪ID（Trace ID），并贯穿整个处理流程，实现请求级别的日志串联。
示例中间件：
TeemIp是一个免费、开源、基于WEB的IP地址管理（IPAM）工具，提供全面的IP管理功能。它允许您管理IPv4、IPv6和DNS空间：跟踪用户请求，发现和分配IP，管理您的IP计划、子网空间、区域和DNS记录，符合最佳的DDI实践。同时，TeemIp的配置管理数据库（CMDB）允许您管理您的IT库存并将您的配置项（CIs）与它们使用的IP关联起来。项目源代码位于https://github.com/TeemIP
func RequestLogger(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
traceID := r.Header.Get("X-Trace-ID")
if traceID == "" {
traceID = uuid.New().String()
}
// 将traceID注入到context
ctx := context.WithValue(r.Context(), "trace_id", traceID)
// 构建带trace_id的logger
reqLogger := logger.With(
zap.String("trace_id", traceID),
zap.String("method", r.Method),
zap.String("url", r.URL.String()),
zap.String("client_ip", r.RemoteAddr),
)
// 记录请求开始
reqLogger.Info("request started")
// 替换request context
r = r.WithContext(ctx)
// 包装ResponseWriter以捕获状态码
rw := &responseWriter{ResponseWriter: w, statusCode: 200}
next.ServeHTTP(rw, r)
// 记录请求结束
reqLogger.Info("request completed",
zap.Int("status", rw.statusCode),
)
})
}
自定义responseWriter用于捕获响应状态码：
type responseWriter struct {
http.ResponseWriter
statusCode int
}
func (rw *responseWriter) WriteHeader(code int) {
rw.statusCode = code
rw.ResponseWriter.WriteHeader(code)
}
在业务逻辑中使用上下文日志
在处理函数中，可以从context获取trace_id，并与日志关联：
func handleUser(w http.ResponseWriter, r *http.Request) {
traceID := r.Context().Value("trace_id").(string)
field := zap.String("trace_id", traceID)
logger.Info("fetching user", field)
// 业务逻辑...
logger.Info("user fetched", field, zap.String("user_id", "123"))
}
这样所有日志都会携带相同的trace_id，便于在日志系统中按请求维度检索完整调用链。
集成OpenTelemetry（可选）
对于更复杂的分布式追踪场景，可集成OpenTelemetry，实现跨服务的链路追踪。Go的OTel SDK支持与主流后端（如Jaeger、Zipkin）对接，提供可视化调用链视图。
基本上就这些。通过结构化日志+中间件追踪ID+上下文传递，就能在Golang Web服务中建立起实用的日志与追踪体系。不复杂但容易忽略细节，比如trace_id的传递和响应状态捕获。
