如何在Golang框架中实现自定义日志中间件-Golang-PHP中文网

go http日志中间件需包装http.responsewriter以捕获状态码、字节数和耗时，不能仅用log.printf；应返回func(http.handler)http.handler闭包，记录method/path/status/size/duration_ms等字段，生产环境须采样且避免解析body。

如何在golang框架中实现自定义日志中间件

Go 的 HTTP 中间件本身不内置日志能力，必须手动封装 http.Handler 或用 http.HandlerFunc 包裹原始 handler，在调用前后注入日志逻辑——这不是“配置”，而是函数组合。

为什么不能直接用 log.Printf 做中间件

单纯在 handler 里写 log.Printf 只能打固定格式、无法获取请求耗时、响应状态码、路径参数等上下文；更关键的是，它发生在 handler 执行中，拿不到响应体大小和真实写入状态（比如 client 提前断连导致 WriteHeader 失败但日志已输出）。真正的中间件需劫持 http.ResponseWriter 实现拦截。

必须包装 http.ResponseWriter，重写 WriteHeader 和 Write 方法才能捕获状态码与字节数
记录开始时间要放在 wrapper 创建前，否则有纳秒级偏差
别用 time.Since 在 defer 里算耗时——如果 handler panic，defer 仍执行，但可能没写 header，日志里状态码会是 0

如何实现可复用的 logging middleware 函数

推荐返回 func(http.Handler) http.Handler 类型的闭包，方便链式使用（如套在 cors、auth 外层）。核心是定义一个实现 http.ResponseWriter 接口的结构体，携带状态码、字节数、是否已写 header 等字段。

type responseWriterWrapper struct {
    http.ResponseWriter
    statusCode int
    written    bool
    size       int
}

func (w *responseWriterWrapper) WriteHeader(statusCode int) {
    w.statusCode = statusCode
    w.written = true
    w.ResponseWriter.WriteHeader(statusCode)
}

func (w *responseWriterWrapper) Write(b []byte) (int, error) {
    if !w.written {
        w.statusCode = http.StatusOK
        w.written = true
    }
    n, err := w.ResponseWriter.Write(b)
    w.size += n
    return n, err
}

中间件函数本身只需提取 request ID（如从 X-Request-ID）、记录起始时间、包装 response writer、调用 next handler、最后打日志行：

Golang Samber Hot

在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。

下载

用 ctx.Value 传 request ID 不推荐——容易被上层覆盖；建议用 req.Header.Get("X-Request-ID") 直接取
日志字段建议至少包含：method, path, status, size, duration_ms, user_agent（可选）
避免在日志里拼接完整 URL（含 query），防止敏感参数泄露；用 req.URL.Path 即可

在 Gin / Echo / Fiber 中怎么接入

各框架对中间件签名约定不同，但底层都是把 http.Handler 转成自身 handler 类型。不要试图“适配所有框架”，而应按框架文档写对应版本：

Gin：接收 gin.HandlerFunc，需把标准中间件转为 func(*gin.Context)，用 c.Writer 获取底层 http.ResponseWriter 并包装
Echo：用 echo.MiddlewareFunc，通过 c.Response().Writer 拿到 http.ResponseWriter，注意 Echo v4+ 默认禁用直接写 header，需调用 c.Response().Before() 注册钩子
Fiber：原生不暴露 http.ResponseWriter，必须用 c.Context.Fasthttp.Response.Body() + 自定义 ctx.SetUserValue 记录状态，不如前两者直观