Gin请求日志记录[编辑 | 编辑源代码]

Gin请求日志记录是Gin框架中用于跟踪和分析HTTP请求的重要功能。通过记录请求的详细信息（如请求方法、路径、状态码、响应时间等），开发者可以监控应用行为、调试问题并优化性能。本章将详细介绍Gin内置的日志中间件、自定义日志配置以及实际应用场景。

概述[编辑 | 编辑源代码]

Gin默认使用`Logger()`中间件记录请求日志，输出格式为Apache Combined Log Format。日志内容包含：

请求时间戳
HTTP方法（GET/POST等）
请求路径
响应状态码
响应时间
客户端IP

日志记录对以下场景至关重要：

调试API异常
分析性能瓶颈
安全审计
用户行为分析

基础用法[编辑 | 编辑源代码]

默认日志中间件[编辑 | 编辑源代码]

启用Gin默认日志：

package main

import "github.com/gin-gonic/gin"

func main() {
    r := gin.Default() // 自动加载Logger和Recovery中间件
    r.GET("/ping", func(c *gin.Context) {
        c.String(200, "pong")
    })
    r.Run(":8080")
}

访问`/ping`后的日志输出示例：

[GIN] 2023/10/01 - 15:04:05 | 200 |     1.002ms |        ::1 | GET     "/ping"

禁用日志[编辑 | 编辑源代码]

若需关闭日志：

r := gin.New() // 不加载默认中间件
// 或
gin.SetMode(gin.ReleaseMode)

高级配置[编辑 | 编辑源代码]

自定义日志格式[编辑 | 编辑源代码]

通过`LoggerWithFormatter`定制日志格式：

r := gin.New()
r.Use(gin.LoggerWithFormatter(func(param gin.LogFormatterParams) string {
    return fmt.Sprintf("%s - [%s] \"%s %s %s %d %s\" %s\n",
        param.ClientIP,
        param.TimeStamp.Format(time.RFC1123),
        param.Method,
        param.Path,
        param.Request.Proto,
        param.StatusCode,
        param.Latency,
        param.ErrorMessage,
    )
}))

输出示例：

::1 - [Mon, 02 Oct 2023 10:00:00 UTC] "GET /ping HTTP/1.1 200 1.002ms" ""

日志输出控制[编辑 | 编辑源代码]

可将日志写入文件：

f, _ := os.Create("gin.log")
gin.DefaultWriter = io.MultiWriter(f, os.Stdout)

性能监控集成[编辑 | 编辑源代码]

结合Prometheus实现指标收集：

import "github.com/prometheus/client_golang/prometheus"

var requestCount = prometheus.NewCounterVec(
    prometheus.CounterOpts{
        Name: "http_requests_total",
        Help: "Total HTTP requests",
    },
    []string{"method", "path", "status"},
)

func main() {
    prometheus.MustRegister(requestCount)
    r := gin.Default()
    r.Use(func(c *gin.Context) {
        c.Next()
        requestCount.WithLabelValues(
            c.Request.Method,
            c.FullPath(),
            strconv.Itoa(c.Writer.Status()),
        ).Inc()
    })
}

实际案例[编辑 | 编辑源代码]

电商API日志分析[编辑 | 编辑源代码]

记录关键路由的请求详情：

func productLogger() gin.HandlerFunc {
    return func(c *gin.Context) {
        start := time.Now()
        c.Next()
        latency := time.Since(start)
        if c.FullPath() == "/products/:id" {
            log.Printf("[PRODUCT] %s | %s | %d | %v",
                c.ClientIP(),
                c.Request.Method,
                c.Writer.Status(),
                latency,
            )
        }
    }
}

错误请求告警[编辑 | 编辑源代码]

当状态码≥400时触发通知：

r.Use(func(c *gin.Context) {
    c.Next()
    if status := c.Writer.Status(); status >= 400 {
        sendAlert(fmt.Sprintf(
            "Error %d on %s %s",
            status,
            c.Request.Method,
            c.Request.URL.Path,
        ))
    }
})