登录
首页 >  Golang >  Go教程

Golang请求日志收集实现详解

时间：2026-04-11 18:48:48 277浏览 收藏

在Go语言Web开发中，通过中间件拦截HTTP请求并自定义包装ResponseWriter，可轻量、高效地实现完整的请求日志收集——精准捕获方法、路径、客户端IP、响应状态码及处理耗时，无需侵入业务逻辑；结合slog还能输出结构化JSON日志，无缝对接ELK、Loki等现代日志系统，为监控、排障与性能分析提供坚实基础。

Golang如何实现请求日志收集

在Go语言项目中实现请求日志收集，核心是通过中间件机制拦截HTTP请求，记录关键信息如请求路径、方法、耗时、客户端IP、响应状态码等。以下是一个结构清晰、实用的实现方式。

使用中间件记录请求日志

Go的net/http包支持中间件模式，可以在处理请求前后插入日志逻辑。

定义一个日志中间件函数，包装原有的http.Handler：

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

        // 记录客户端IP
        clientIP := r.RemoteAddr
        if ip := r.Header.Get("X-Real-IP"); ip != "" {
            clientIP = ip
        } else if ip = r.Header.Get("X-Forwarded-For"); ip != "" {
            clientIP = strings.Split(ip, ",")[0]
        }

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

        // 调用下一个处理器
        next.ServeHTTP(rw, r)

        // 日志输出
        log.Printf(
            "%s %s %s %d %v",
            r.Method,
            r.URL.Path,
            clientIP,
            rw.statusCode,
            time.Since(start),
        )
    })
}

捕获响应状态码和写入器包装

原生http.ResponseWriter不提供获取状态码的方法，需自定义包装类型：

type responseWriter struct {
    http.ResponseWriter
    statusCode int
}

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

这样就能在中间件中准确记录实际返回的状态码，即使发生内部错误也能捕获。

集成到HTTP服务中

将日志中间件应用到路由上：

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "Hello, World!")
    })

    // 使用中间件包裹处理器
    loggedMux := LoggingMiddleware(mux)

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

每次请求都会输出类似日志：

GET / 127.0.0.1:54321 200 123.456µs

进阶：结构化日志与输出控制

可结合log/slog（Go 1.21+）输出JSON格式日志，便于收集分析：

logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
logger.Info("request",
    "method", r.Method,
    "path", r.URL.Path,
    "ip", clientIP,
    "status", rw.statusCode,
    "duration_ms", time.Since(start).Milliseconds(),
)

也可将日志写入文件或发送到ELK、Loki等日志系统。

基本上就这些。通过中间件加ResponseWriter包装，能干净地实现完整的请求日志收集，不影响业务逻辑，也易于扩展。

到这里，我们也就讲完了《Golang请求日志收集实现详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>