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

Go Web服务中应通过中间件统一记录请求日志，捕获路径、耗时、状态码及错误信息，结合请求ID实现结构化、分级、高性能日志追踪。

在 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，并记录完整堆栈（生产环境建议关闭堆栈，只记摘要）

区分日志级别与输出目标

访问日志（INFO 级）和错误日志（ERROR/WARN 级）最好分开写入不同文件或流，便于后续采集（如 Filebeat、Loki）。

用 log.New(os.Stdout, "[ACCESS] ", log.LstdFlags|log.Lmicroseconds) 初始化访问日志器
用另一个 log.New(os.Stderr, "[ERROR] ", ...) 处理错误，确保 ERROR 日志不被缓冲、不丢失
避免在高并发下直接调用 log.Printf —— 可考虑加简单缓冲或用 zap/logrus 等高性能日志库（非必须，但推荐）

可选：集成请求 ID 与链路追踪基础

即使不接入 Jaeger 或 OpenTelemetry，加一个 X-Request-ID 响应头 + 日志关联，就能极大提升排障效率。

检查请求是否自带 X-Request-ID，有则复用；无则生成新 ID
写入响应头：w.Header().Set("X-Request-ID", reqID)
所有日志（包括业务逻辑中的）都带上该 ID，grep 一条请求的全链路日志就非常方便

# js # json # go # golang # 字节 # access # 栈 # ai # 路由 # 状态码 # 开发环境 # 标准库 # 中间件 # if # for # Error # printf # 堆 # 并发 # http

返回目录在线咨询

上一篇：如何监控阿里云服务器上的多个网站性能和流量？
下一篇：网站制作改字体怎么改,如何把网址转换为文字超链接？

您的项目需求