首页 > Golang > Go教程

Golang请求日志收集实现教程

时间：2025-12-24 22:02:41 346浏览收藏

知识点掌握了，还需要不断练习才能熟练运用。下面golang学习网给大家带来一个Golang开发实战，手把手教大家学习《Golang请求日志收集实现方法》，在实现功能的过程中也带大家重新温习相关知识点，温故而知新，回头看看说不定又有不一样的感悟！

通过中间件拦截请求并包装ResponseWriter，可记录方法、路径、IP、状态码和耗时。1. 定义LoggingMiddleware捕获请求前后信息；2. 自定义responseWriter获取状态码；3. 集成到mux路由；4. 可选slog输出结构化日志。

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学习网公众号吧！