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

P粉602998670

发布时间：2025-12-30 09:39:07

453人浏览过

来源于php中文网

原创

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 中配置一次）：

立即学习“go语言免费学习笔记（深入）”；

Winston AI

强大的AI内容检测解决方案

下载

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]")