golang如何在Gin中实现日志中间件_golang Gin日志中间件实现方法-Golang-PHP中文网

默认 gin.logger() 不够用，因它仅记录status、method、path等基础信息，不记录请求体、响应体及错误详情，也无法捕获panic堆栈。

golang如何在gin中实现日志中间件_golang gin日志中间件实现方法

直接用 gin.Logger() 就能开箱即用，但默认不记录请求体、响应体和错误详情——真要调试或审计，得自己补全。

为什么默认 `gin.Logger()` 不够用

它只输出基础信息：status、method、path、latency、ip，连 Content-Type 都不打。遇到 400 或 500，你根本不知道客户端发了啥、服务端返回了啥。更麻烦的是，它不捕获 panic 后的堆栈，线上出错只能靠猜。

常见错误现象：POST /api/v1/user 400 12ms —— 看不出是 JSON 格式错、字段缺失，还是结构体绑定失败。

默认中间件不读取 c.Request.Body（读完就不可重放）
不写入 c.Errors 中的校验错误（比如 binding 失败）
不兼容 gin.Recovery() 的 panic 日志格式，容易漏掉关键上下文

手动实现带请求/响应体的日志中间件

核心是用 c.Request.Body 和 responseWriter 包装器截获数据。注意：必须在其他中间件（如 binding）之前注册，否则 body 已被读空。

实操建议：

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

用 io.TeeReader 把请求体复制进 bytes.Buffer，再塞回 c.Request.Body
自定义 responseWriter 实现 http.ResponseWriter 接口，缓存 WriteHeader 和 Write 结果
只对特定 Content-Type（如 application/json）记录 body，避免日志爆炸
加长度限制（比如 maxBodySize: 1024），防止大文件上传撑爆内存

示例关键逻辑：

func LoggerWithBody() gin.HandlerFunc {
    return func(c *gin.Context) {
        var bodyBytes []byte
        if c.Request.Body != nil {
            bodyBytes, _ = io.ReadAll(c.Request.Body)
        }
        c.Request.Body = io.NopCloser(bytes.NewBuffer(bodyBytes))

        // 包装 responseWriter
        rw := &responseWriter{ResponseWriter: c.Writer, statusCode: 200}
        c.Writer = rw

        c.Next()

        // 打日志：method、path、status、body（截断）、error（如果有）
        if len(bodyBytes) > 0 && len(bodyBytes)  0 && len(rw.body)  0 {
            log.Printf("[ERR] %v", c.Errors.ByType(gin.ErrorTypeBind))
        }
    }
}