GolangWeb日志记录与请求追踪实现-Golang-PHP中文网

GolangWeb日志记录与请求追踪实现

P粉602998670

发布： 2025-09-07 09:09:02

原创

376人浏览过

使用zap实现结构化日志与请求追踪，通过中间件生成trace_id并注入context，结合自定义ResponseWriter记录状态码，确保日志携带trace_id实现请求链路串联，提升系统可观测性。

golangweb日志记录与请求追踪实现

在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 - IPAM and DDI solution

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，便于在日志系统中按请求维度检索完整调用链。