当前位置：首页 > 文章列表 > Golang > Go教程 > Golang实现Web日志统一记录方法

Golang实现Web日志统一记录方法

2026-01-03 18:43:38 0浏览收藏

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习Golang相关编程知识。下面本篇文章就来带大家聊聊《Golang实现Web日志统一记录方法》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

Go Web 应用统一日志需用 zap 等结构化库替代标准 log，通过中间件自动记录请求路径、方法、状态码、耗时等字段，并在业务层用 logger.With 添加 traceID 等上下文，禁用敏感信息，分级输出 JSON 日志。

如何使用Golang实现Web应用日志记录_统一输出日志信息

在 Go Web 应用中实现统一日志记录，核心是使用结构化日志库（如 zap 或 zerolog）替代默认 log，并结合中间件将请求上下文（如路径、方法、耗时、状态码）自动注入日志，避免手动写重复的 log.Printf。

选用高性能结构化日志库（推荐 zap）

zap 是 Uber 开源的高性能日志库，比标准库快数倍，支持字段结构化、多输出目标（文件、控制台、网络等），且线程安全。安装：

go get go.uber.org/zap

初始化一个全局 logger（建议在 main.go 中配置一次）：

var logger *zap.Logger
func init() {
  cfg := zap.NewProductionConfig()
  cfg.OutputPaths = []string{"stdout", "logs/app.log"}
  cfg.ErrorOutputPaths = []string{"stderr", "logs/error.log"}
  var err error
  logger, err = cfg.Build()
  if err != nil {
    panic(err)
  }
}

通过 HTTP 中间件统一记录请求日志

在 Gin / Echo / net/http 路由前插入中间件，自动记录每次请求的完整信息，无需每个 handler 里手写日志。

以 net/http 为例：

func loggingMiddleware(next http.Handler) http.Handler {
  return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    start := time.Now()

    // 包装 ResponseWriter 以捕获状态码和响应大小
    rw := &responseWriter{ResponseWriter: w, statusCode: http.StatusOK}

    next.ServeHTTP(rw, r)

    duration := time.Since(start).Milliseconds()
    logger.Info("http request",
      zap.String("method", r.Method),
      zap.String("path", r.URL.Path),
      zap.Int("status", rw.statusCode),
      zap.Float64("duration_ms", duration),
      zap.String("ip", getClientIP(r)),
    )
  })
}

关键点：
• 自定义 responseWriter 实现 WriteHeader 拦截，获取真实状态码
• 使用 zap.String/zap.Int 等类型化字段，便于后续日志分析与检索
• 不要直接记录 r.Header 或 r.Body（可能已读取或不可复用）

业务逻辑中规范打日志（带上下文 + 错误链路）

在 handler 或 service 层，使用 logger.With() 追加请求级上下文（如 traceID、userID），让日志可关联：

func userHandler(w http.ResponseWriter, r *http.Request) {
  ctx := r.Context()
  traceID := r.Header.Get("X-Trace-ID")
  userID := r.URL.Query().Get("user_id")

  log := logger.With(
    zap.String("trace_id", traceID),
    zap.String("user_id", userID),
    zap.String("handler", "userHandler"),
  )

  err := doSomething(ctx, userID)
  if err != nil {
    log.Error("failed to process user", zap.Error(err))
    http.Error(w, "internal error", http.StatusInternalServerError)
    return
  }
  log.Info("user processed successfully")
}

注意：
• zap.Error(err) 会自动展开错误栈（尤其配合 github.com/pkg/errors 或 Go 1.13+ 的 %w）
• 避免用 fmt.Sprintf 拼接错误信息再传给 zap.String，丢失原始错误类型
• 敏感字段（如密码、token）禁止写入日志，可用占位符如 zap.String("token", "[redacted]")