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

用Golang开发HTTP请求日志记录系统,核心思路是通过中间件拦截所有进入的HTTP请求,提取关键信息并写入日志。Go标准库中的net/http包足够强大,配合结构化日志工具(如log或zap),可以快速构建一个轻量且高效的日志系统。
使用中间件捕获请求信息
在Go的HTTP服务中,中间件是最适合做日志记录的位置。它能访问请求和响应的基本数据,并在请求处理前后执行逻辑。
一个典型的日志中间件会记录以下内容:
- 客户端IP地址
- 请求方法(GET、POST等)
- 请求路径
- HTTP协议版本
- 用户代理(User-Agent)
- 响应状态码
- 处理耗时
示例代码:
立即学习“go语言免费学习笔记(深入)”;
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提升性能和灵活性:
本系统基于VS2005+SQL2005开发, 基本功能模块:供求信息、展会信息、企业商铺、产品库、企业目录信息评论会员服务在线申请在线留言,留言可直接发送到用户邮箱后台数据库备份登陆日志操作日志管理员分级管理权限后台路径 http://你的网站地址/sitemanage用户名:oyaya 密码 123456数据库存放地址 /App_Data 文件夹下oyaya_mingpian.rar
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项目中都够用。









