17370845950

如何在Golang中管理Web日志_记录请求和响应信息
在 Go 中记录 Web 请求和响应信息的关键是通过中间件包装 http.ResponseWriter,捕获状态码与响应体大小,结合请求元数据提取和结构化日志输出;需自定义 ResponseWriter 重写 WriteHeader 和 Write 方法,过滤敏感字段,使用 zap 等库按状态码分级记录结构化日志。

在 Go 中记录 Web 请求和响应信息,关键不是“拦截响应体”,而是通过中间件包装 http.ResponseWriter,同时结合请求解析与结构化日志输出。原生 net/http 不提供响应内容访问接口,需手动封装。

用自定义 ResponseWriter 捕获状态码和响应体大小

实现一个包装器,嵌入原生 http.ResponseWriter,重写 WriteHeader Write 方法,记录真实状态码和写入字节数:

  • 定义结构体(如 responseWriter),保存 statusCodewrittensize
  • WriteHeader 中缓存状态码(避免被后续 Write 覆盖)
  • Write 中累加写入长度,并调用底层 Write
  • 注意:不建议完整读取并缓存响应体(内存/性能风险),除非业务强依赖响应内容(此时应单独做逻辑处理)

提取请求信息:URL、方法、IP、耗时、查询参数等

在中间件入口处即可获取大部分请求元数据:

  • r.Methodr.URL.Pathr.URL.RawQuery 直接可用
  • 客户端 IP 推荐用 r.Header.Get("X-Forwarded-For") 回退到 r.RemoteAddr
  • time.Now() 记录开始时间,defer 中计算耗时
  • 敏感字段(如密码、token)务必过滤,可用白名单或正则脱敏(如 strings.ReplaceAll(q, "token=", "token=[REDACTED]")

结构化日志输出(推荐 zap 或 zerolog)

避免拼接字符串日志,使用结构化日志库提升可检索性:

  • zap.With(...)zerolog.Dict().Str(...).Int(...) 添加字段
  • 必填字段建议:method、path、status、size、duration_ms、ip、user_agent、trace_id(如有)
  • 错误日志单独记录(如 logger.Error("request failed", zap.Error(err))),避免混在访问日志中
  • 日志级别按需设定:2xx 用 Info,4xx 用 Warn,5xx 用 Error

轻量级示例(基于 net/http + zap)

以下是一个可直接运行的中间件片段:

func loggingMiddleware(next http.Handler) http.Handler {
  return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    start := time.Now()
    rw := &responseWriter{ResponseWriter: w, statusCode: http.StatusOK}
    next.ServeHTTP(rw, r)
    duration := time.Since(start).Milliseconds()
    fields := []zap.Field{
      zap.String("method", r.Method),
      zap.String("path", r.URL.Path),
      zap.Int("status", rw.statusCode),
      zap.Int64("size", rw.size),
      zap.Float64("duration_ms", duration),
      zap.String("ip", getClientIP(r)),
    }
    if rw.statusCode >= 400 {
      logger.Warn("http request", fields...)
    } else {
      logger.Info("http request", fields...)
    }
  })
}