答案：通过中间件捕获请求信息并记录日志。使用自定义ResponseWriter获取状态码，结合slog输出结构化日志，注意避免敏感信息和性能影响，适用于标准库或第三方框架。
在Go语言开发中，记录HTTP请求日志是服务可观测性的基础能力。无论是调试问题、监控流量，还是审计访问行为，都需要对每个进入系统的HTTP请求进行有效记录。实现这一功能不需要依赖复杂框架，通过中间件机制即可优雅完成。
使用中间件记录请求日志
Go的net/http包允许我们通过中间件（Middleware）包装处理器，从而在请求处理前后插入逻辑。这是实现日志记录最常见也最灵活的方式。
一个典型的日志中间件会捕获以下信息：
- 客户端IP地址
- HTTP方法（GET、POST等）
- 请求路径和查询参数
- 响应状态码
- 处理耗时
下面是一个实用的日志中间件示例：
立即学习“go语言免费学习笔记（深入）”；
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
ip := r.RemoteAddr
method := r.Method
path := r.URL.Path
// 包装ResponseWriter以捕获状态码
rw := &responseWriter{ResponseWriter: w, statusCode: 200}
next.ServeHTTP(rw, r)
duration := time.Since(start)
log.Printf(
"ip=%s method=%s path=%s status=%d duration=%v",
ip, method, path, rw.statusCode, duration,
)
})
}
// 自定义ResponseWriter以获取状态码
type responseWriter struct {
http.ResponseWriter
statusCode int
}
func (rw *responseWriter) WriteHeader(code int) {
rw.statusCode = code
rw.ResponseWriter.WriteHeader(code)
}
集成到HTTP服务中
将上述中间件应用到你的路由非常简单。无论你使用标准库还是第三方路由器（如Gorilla Mux），都可以轻松集成。
例如，使用标准http.ServeMux：
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/api/hello", helloHandler)
// 应用日志中间件
loggedMux := loggingMiddleware(mux)
log.Println("Server starting on :8080")
http.ListenAndServe(":8080", loggedMux)
}
如果你使用Gin框架，它自带gin.Logger()中间件，也可以自定义输出格式。
优化日志输出格式
生产环境建议使用结构化日志，比如JSON格式，便于日志系统（如ELK、Loki）解析。
可以结合log/slog（Go 1.21+）或第三方库如zap、logrus输出结构化内容：
logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
logger.Info("http_request",
"ip", ip,
"method", method,
"path", path,
"status", rw.statusCode,
"duration_ms", duration.Milliseconds(),
)
这样每条日志都是一个JSON对象，方便后续分析和告警。
注意事项与最佳实践
实际使用中需注意几点：
- 避免记录敏感信息，如Authorization头、密码字段
- 大文件上传或下载场景下，考虑是否记录请求体
- 高并发下确保日志写入不影响性能，可异步写入或限流
- 统一日志字段命名，便于多服务聚合分析
基本上就这些。通过中间件方式实现HTTP请求日志，代码清晰、复用性强，是Go服务中的标准做法。不复杂但容易忽略细节，比如状态码捕获和延迟计算，写的时候注意包装ResponseWriter即可。
