答案：通过中间件记录HTTP请求日志并使用结构化日志库如zap输出JSON格式日志，便于后续分析。1. 使用自定义responseWriter捕获状态码；2. 在中间件中记录IP、方法、URI、状态码、耗时和User-Agent；3. 接入zap等库实现结构化日志；4. 利用grep、awk、jq等工具进行高频接口、错误请求、慢响应和IP访问量分析。
在 Golang 中开发 HTTP 接口时，记录和分析请求日志是调试、监控和安全审计的重要手段。一个良好的日志系统能帮助你快速定位问题、了解用户行为，并为性能优化提供数据支持。下面通过一个简单但实用的示例，展示如何实现 HTTP 接口的日志记录与基本分析。
使用中间件记录 HTTP 请求日志
Go 的 http.Handler 支持中间件模式，我们可以通过封装 handler 来实现统一的日志记录。
以下是一个基础的日志中间件：
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
uri := r.URL.RequestURI()
userAgent := r.Header.Get("User-Agent")
// 包装 ResponseWriter 以获取状态码
rw := &responseWriter{ResponseWriter: w, statusCode: http.StatusOK}
// 调用实际处理函数
next.ServeHTTP(rw, r)
// 日志输出
log.Printf(
"ip=%s method=%s uri=%s status=%d duration=%v user_agent=%q",
ip, method, uri, rw.statusCode, time.Since(start), userAgent,
)
})
}
// 自定义 ResponseWriter 获取状态码
type responseWriter struct {
http.ResponseWriter
statusCode int
}
func (rw *responseWriter) WriteHeader(code int) {
rw.statusCode = code
rw.ResponseWriter.WriteHeader(code)
}
接入日志中间件到 HTTP 服务
将上述中间件应用到你的路由中，可以对所有请求进行统一记录。
立即学习“go语言免费学习笔记（深入）”；
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/api/hello", func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
json.NewEncoder(w).Encode(map[string]string{
"message": "Hello, World!",
})
})
// 使用中间件包装 mux
loggedMux := loggingMiddleware(mux)
log.Println("Server starting on :8080...")
http.ListenAndServe(":8080", loggedMux)
}
访问 /api/hello 后，控制台会输出类似：
2025/04/05 10:00:00 ip=127.0.0.1:56789 method=GET uri=/api/hello status=200 duration=123.45µs user_agent="curl/7.68.0"
结构化日志与分析建议
默认的 log 包输出的是文本日志，不利于后续分析。推荐使用 zap 或 logrus 等支持结构化日志的库。
例如使用 zap：
import "go.uber.org/zap"
var logger *zap.Logger
func init() {
var err error
logger, err = zap.NewProduction()
if err != nil {
panic(err)
}
}
// 在中间件中替换 log.Printf 为：
logger.Info("http_request",
zap.String("ip", ip),
zap.String("method", method),
zap.String("uri", uri),
zap.Int("status", rw.statusCode),
zap.Duration("duration", time.Since(start)),
zap.String("user_agent", userAgent),
)
输出将是 JSON 格式，便于被 ELK、Loki 等系统采集和查询。
简单日志分析技巧
有了结构化日志后，你可以进行一些基础分析：
- 统计高频接口：grep '"uri":"/api/' logs.json | awk '{print $8}' | sort | uniq -c | sort -nr
- 查看错误请求：grep '"status":5' logs.json
- 分析响应慢的请求：jq 'select(.duration > 1)' logs.json
- 按 IP 统计访问量：grep '"ip"' logs.json | awk '{print $6}' | sort | uniq -c
基本上就这些。通过中间件记录日志，再配合结构化输出，就能为 Go 服务构建一个轻量但有效的日志体系。不复杂但容易忽略。
