首页 > Golang > Go教程

GolangHTTP日志记录方法详解

时间：2025-11-22 11:01:25 255浏览收藏

在Golang实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《Golang实现HTTP请求日志记录方法》，聊聊，希望可以帮助到正在努力赚钱的你。

使用中间件记录HTTP请求日志，通过拦截请求获取客户端IP、方法、路径、状态码等信息，结合zap实现结构化JSON日志输出，并利用channel异步写入与lumberjack轮转日志文件，确保高性能与可维护性。

Golang如何开发HTTP请求日志记录系统

用Golang开发HTTP请求日志记录系统，核心思路是通过中间件拦截所有进入的HTTP请求，提取关键信息并写入日志。Go标准库中的net/http包足够强大，配合结构化日志工具（如log或zap），可以快速构建一个轻量且高效的日志系统。

使用中间件捕获请求信息

在Go的HTTP服务中，中间件是最适合做日志记录的位置。它能访问请求和响应的基本数据，并在请求处理前后执行逻辑。

一个典型的日志中间件会记录以下内容：

客户端IP地址
请求方法（GET、POST等）
请求路径
HTTP协议版本
用户代理（User-Agent）
响应状态码
处理耗时

示例代码：

func loggingMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()
        uri := r.RequestURI
        method := r.Method
        ip := r.RemoteAddr
        ua := r.Header.Get("User-Agent")

        // 包装ResponseWriter以捕获状态码
        rw := &responseWriter{ResponseWriter: w, statusCode: 200}
        next.ServeHTTP(rw, r)

        duration := time.Since(start)

        log.Printf(
            "%s | %s | %s | %s | %s | %d | %v",
            ip, method, uri, ua, r.Proto,
            rw.statusCode, duration,
        )
    })
}

// 自定义ResponseWriter以获取状态码
type responseWriter struct {
    http.ResponseWriter
    statusCode int
}

func (rw *responseWriter) WriteHeader(code int) {
    rw.statusCode = code
    rw.ResponseWriter.WriteHeader(code)
}

结构化日志输出

纯文本日志不利于后期分析。推荐使用JSON格式输出，便于对接ELK、Loki等日志系统。

可使用第三方库如uber-go/zap提升性能和灵活性：

logger, _ := zap.NewProduction()
defer logger.Sync()

// 在中间件中使用
logger.Info("http request",
    zap.String("ip", ip),
    zap.String("method", method),
    zap.String("uri", uri),
    zap.String("user_agent", ua),
    zap.Int("status", rw.statusCode),
    zap.Duration("duration", duration),
)

异步写入与日志轮转

高频请求下，同步写日志会影响性能。可通过channel将日志消息发送到后台goroutine异步处理。

同时，使用lumberjack等库实现日志文件切割，避免单个文件过大。

配置示例：

&lumberjack.Logger{
    Filename:   "/var/log/myapp/access.log",
    MaxSize:    100, // MB
    MaxBackups: 3,
    MaxAge:     7, // 天
    Compress:   true,
}

结合zap使用：

writeSyncer := zapcore.AddSync(&lumberjack.Logger{...})
core := zapcore.NewCore(encoder, writeSyncer, level)
logger := zap.New(core)

基本上就这些。一个实用的日志系统不需要复杂设计，关键是稳定、低开销、格式清晰。中间件+结构化日志+异步落地，这套组合在大多数Go项目中都够用。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《GolangHTTP日志记录方法详解》文章吧，也可关注golang学习网公众号了解相关技术文章。