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、订单号）。
立即学习“go语言免费学习笔记（深入）”；
- 为每个请求生成唯一 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 一条请求的全链路日志就非常方便
