Golang记录Web请求日志的几种方法

目前golang学习网上已经有很多关于Golang的文章了，自己在初次阅读这些文章中，也见识到了很多学习思路；那么本文《Golang实现Web请求日志记录方法》，也希望能帮助到大家，如果阅读完后真的对你学习Golang有帮助，欢迎动动手指，评论留言并分享~

最轻量可控的HTTP请求日志方式是自定义loggingResponseWriter拦截WriteHeader和Write以捕获状态码与响应长度，并在中间件中记录方法、路径、状态码、耗时及可信客户端IP，同时禁用http.Server.DebugPrint和默认错误日志避免干扰。

用 http.Handler 包裹原始 handler 实现请求日志

最轻量、最可控的方式是写一个中间件式 wrapper，不依赖第三方库，直接操作 http.ResponseWriter 和 *http.Request。关键点在于：必须用自定义的 ResponseWriter 拦截状态码和响应体长度，否则只能记录请求而无法获取真实 HTTP 状态。

• 不能只靠 log.Printf 打印 r.Method 和 r.URL.Path 就完事——这漏掉了状态码、耗时、客户端 IP 等关键字段
• 需嵌入 http.ResponseWriter 接口所有方法（Write、WriteHeader、Flush 等），并在 WriteHeader 中捕获最终状态码
• 客户端真实 IP 要从 r.Header.Get("X-Forwarded-For") 或 r.RemoteAddr 取，但注意反向代理场景下前者可能被伪造，建议结合 TrustedProxies 过滤

type loggingResponseWriter struct {
	http.ResponseWriter
	statusCode int
	written    int
}

func (lrw *loggingResponseWriter) WriteHeader(code int) {
	lrw.statusCode = code
	lrw.ResponseWriter.WriteHeader(code)
}

func (lrw *loggingResponseWriter) Write(b []byte) (int, error) {
	if lrw.statusCode == 0 {
		lrw.statusCode = http.StatusOK
	}
	n, err := lrw.ResponseWriter.Write(b)
	lrw.written += n
	return n, err
}

func LoggingMiddleware(next http.Handler) http.Handler {
	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		start := time.Now()
		lrw := &loggingResponseWriter{
			ResponseWriter: w,
			statusCode:     0,
		}
		next.ServeHTTP(lrw, r)

		clientIP := r.Header.Get("X-Forwarded-For")
		if clientIP == "" {
			clientIP = strings.Split(r.RemoteAddr, ":")[0]
		}

		log.Printf("[%s] %s %s %d %dms %s",
			time.Now().Format("2006/01/02 15:04:05"),
			r.Method,
			r.URL.Path,
			lrw.statusCode,
			int(time.Since(start).Milliseconds()),
			clientIP,
		)
	})
}

避免在 net/http 日志中重复打印 panic 堆栈

默认 http.Server 在 handler panic 时会调用 log.Panic 输出到标准错误，如果你已在 middleware 里 recover 并自定义了错误日志，就容易出现双份 panic 日志，干扰排查。

• 显式设置 http.Server.ErrorLog 为 nil 或自定义 log.Logger，防止底层自动打堆栈
• 在 middleware 的 defer/recover 中统一处理 panic，并记录完整堆栈（用 debug.PrintStack() 或 runtime/debug.Stack()）
• 不要在 recover 后简单 log.Print 错误字符串——它不含文件名和行号，定位困难

使用 chi/middleware.Logger 时注意字段缺失问题

chi/middleware.Logger 默认只输出方法、路径、状态码和耗时，不包含客户端 IP、User-Agent、Referer 等常用字段，且日志格式固定、不易扩展。

• 它内部用 ctx.Value 存储 request ID，但不会自动注入 X-Request-ID header，需配合 chi/middleware.RequestID
• 若要加 Client IP，得自己 wrap 一次：从 r.Context().Value(chi.RouteCtxKey) 拿不到 IP，必须从 r 本身取
• 它的日志输出走 log.Printf，无法对接 zap 或 zerolog 等结构化日志库，高并发下有性能损耗

生产环境务必关闭 http.Server.DebugPrint

Go 1.22+ 引入了 http.Server.DebugPrint 字段，默认为 true，会在启动时打印路由树；但更隐蔽的是，它还会在每次 404 或方法不匹配时往 os.Stderr 写调试信息——这在容器环境中常被误当成应用错误日志收集，造成告警噪音。

• 显式设为 false：srv := &http.Server{DebugPrint: false, ...}
• 该字段不影响你自己的日志逻辑，但和 log.Printf 混在一起时极难区分来源
• 如果用了 gin 或 echo 等框架，它们的 debug mode 也会开启类似行为，需单独关掉

日志格式里时间戳精度、状态码捕获时机、客户端 IP 的可信来源，这三处最容易出偏差。别假设 r.RemoteAddr 总是真实 IP，也别相信任何中间件默认就填全了你要的字段。

好了，本文到此结束，带大家了解了《Golang记录Web请求日志的几种方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！