当前位置：首页 > 文章列表 > Golang > Go教程 > Golang请求日志记录与错误追踪方法

Golang请求日志记录与错误追踪方法

2026-05-12 19:12:49 0浏览收藏

本文深入探讨了在 Go Web 服务中构建轻量、高效且可观测的请求日志与错误追踪体系的核心实践：通过自定义中间件统一捕获请求路径、客户端 IP、响应状态码、耗时等关键指标，结合请求 ID 实现全链路日志关联；强调结构化记录错误（含上下文如用户 ID、堆栈摘要）与 panic 恢复机制；指导按级别分离日志输出、避免性能陷阱，并给出从标准库出发、零依赖即可落地的实用代码示例——让你在不引入复杂框架的前提下，快速获得“记得准、查得快、扛得住”的生产级日志能力。

如何使用Golang实现请求日志记录_追踪访问和错误信息

在 Go Web 服务中，记录请求日志（含访问路径、耗时、状态码）和错误信息是可观测性的基础。关键不是“记多少”，而是“记得准、查得快、不影响性能”。下面用标准库 + 少量中间件逻辑就能实现轻量但实用的日志追踪。

使用中间件统一记录 HTTP 请求日志

在 http.Handler 链中插入日志中间件，是最自然的方式。它能捕获所有请求入口，无需每个路由重复写日志代码。

包装原始 handler，记录开始时间、方法、路径、客户端 IP
用 ResponseWriter 包装器捕获真实响应状态码和字节数
计算耗时，避免用 time.Since() 在 defer 中导致精度偏差（应记录结束时间后显式计算）

示例片段：

func loggingMiddleware(next http.Handler) http.Handler {
  return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    start := time.Now()
    ip := r.RemoteAddr
    if forwarded := r.Header.Get("X-Forwarded-For"); forwarded != "" {
      ip = strings.Split(forwarded, ",")[0]
    }

    lw := &loggingResponseWriter{ResponseWriter: w, status: 200}
    next.ServeHTTP(lw, r)

    duration := time.Since(start).Milliseconds()
    log.Printf("[ACCESS] %s %s %s %d %.2fms", r.Method, r.URL.Path, ip, lw.status, duration)
  })
}

捕获并结构化记录错误信息

HTTP 错误（如 400/500）和 panic 都需记录。不要只打 log.Println(err)，要带上下文：请求 ID、路径、时间、错误堆栈（仅开发环境）、关键参数（如用户 ID、订单号）。

为每个请求生成唯一 trace ID（可用 uuid.NewString()），通过 context.WithValue 透传
在 handler 内部发生错误时，用该 ID 关联日志；例如：log.Printf("[ERROR][%s] failed to parse JSON: %v", reqID, err)
用 recover() 捕获 panic，并记录完整堆栈（生产环境建议关闭堆栈，只记摘要）