当前位置：首页 > 文章列表 > Golang > Go教程 > Golang记录HTTP请求日志方法

Golang记录HTTP请求日志方法

2026-03-24 22:49:36 0浏览收藏

本文深入介绍了如何在Go语言中通过轻量级中间件优雅实现HTTP请求日志记录，涵盖从基础原理（利用自定义ResponseWriter准确捕获状态码和耗时）到生产就绪的实践要点（如结构化JSON日志、slog集成、敏感信息过滤、性能优化），既适用于标准net/http库，也兼容Gin等主流框架，是一份兼顾简洁性、可观测性与工程鲁棒性的实用指南。

Golang如何实现HTTP请求日志记录_Golang HTTP请求日志实践

在Go语言开发中，记录HTTP请求日志是服务可观测性的基础能力。无论是调试问题、监控流量，还是审计访问行为，都需要对每个进入系统的HTTP请求进行有效记录。实现这一功能不需要依赖复杂框架，通过中间件机制即可优雅完成。

使用中间件记录请求日志

Go的net/http包允许我们通过中间件（Middleware）包装处理器，从而在请求处理前后插入逻辑。这是实现日志记录最常见也最灵活的方式。

一个典型的日志中间件会捕获以下信息：

客户端IP地址
HTTP方法（GET、POST等）
请求路径和查询参数
响应状态码
处理耗时

下面是一个实用的日志中间件示例：

func loggingMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()
        ip := r.RemoteAddr
        method := r.Method
        path := r.URL.Path

        // 包装ResponseWriter以捕获状态码
        rw := &responseWriter{ResponseWriter: w, statusCode: 200}
        next.ServeHTTP(rw, r)

        duration := time.Since(start)

        log.Printf(
            "ip=%s method=%s path=%s status=%d duration=%v",
            ip, method, path, rw.statusCode, duration,
        )
    })
}

// 自定义ResponseWriter以获取状态码
type responseWriter struct {
    http.ResponseWriter
    statusCode int
}

func (rw *responseWriter) WriteHeader(code int) {
    rw.statusCode = code
    rw.ResponseWriter.WriteHeader(code)
}

集成到HTTP服务中

将上述中间件应用到你的路由非常简单。无论你使用标准库还是第三方路由器（如Gorilla Mux），都可以轻松集成。

例如，使用标准http.ServeMux：

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/api/hello", helloHandler)

    // 应用日志中间件
    loggedMux := loggingMiddleware(mux)

    log.Println("Server starting on :8080")
    http.ListenAndServe(":8080", loggedMux)
}

如果你使用Gin框架，它自带gin.Logger()中间件，也可以自定义输出格式。

优化日志输出格式

生产环境建议使用结构化日志，比如JSON格式，便于日志系统（如ELK、Loki）解析。

可以结合log/slog（Go 1.21+）或第三方库如zap、logrus输出结构化内容：

logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))

logger.Info("http_request",
    "ip", ip,
    "method", method,
    "path", path,
    "status", rw.statusCode,
    "duration_ms", duration.Milliseconds(),
)

这样每条日志都是一个JSON对象，方便后续分析和告警。