使用标准库log可实现基础日志输出，结合文件写入和中间件记录请求信息；2. 采用zap、logrus或slog进行结构化日志，提升可读性与分析效率；3. 通过中间件统一记录请求响应详情，包括状态码、耗时等；4. 利用rotatelogs或logrotate实现日志轮转，避免磁盘占满；5. 合理配置多输出目标以兼顾调试与生产环境需求。
在Golang中构建Web服务器时，日志记录是排查问题、监控服务状态和审计请求的重要手段。合理地处理日志不仅能提升系统的可观测性，还能帮助快速定位异常。以下是几种常见的Golang Web服务器日志处理方法，涵盖标准库使用、结构化日志、中间件集成等实用技巧。
使用标准库log进行基础日志输出
Go的log包提供了开箱即用的日志功能，适合简单的日志需求。
你可以将HTTP请求的基本信息（如方法、路径、状态码、耗时）打印到控制台或写入文件：
- 通过log.Println输出请求信息
- 结合os.File将日志写入文件
- 使用log.SetOutput统一设置输出目标
示例代码：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"log"
"net/http"
"os"
"time"
)
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
next.ServeHTTP(w, r)
log.Printf("%s %s %s %v", r.RemoteAddr, r.Method, r.URL.Path, time.Since(start))
})
}
func main() {
file, err := os.OpenFile("server.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
if err != nil {
log.Fatal("无法打开日志文件:", err)
}
defer file.Close()
log.SetOutput(file)
mux := http.NewServeMux()
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("Hello, World!"))
})
http.ListenAndServe(":8080", loggingMiddleware(mux))
}
使用结构化日志提升可读性和分析效率
标准库的文本日志不利于机器解析。采用结构化日志（如JSON格式）更利于集中收集和分析。
推荐使用zap、logrus或slog（Go 1.21+内置）实现结构化输出。
- zap性能高，适合生产环境
- logrus语法简洁，支持丰富的Hook
- slog为官方结构化日志包，轻量且无需引入第三方依赖
使用slog示例：
handler := slog.NewJSONHandler(os.Stdout, nil)
logger := slog.New(handler)
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
logger.Info("HTTP请求",
"method", r.Method,
"path", r.URL.Path,
"client_ip", r.RemoteAddr,
"user_agent", r.UserAgent(),
)
w.Write([]byte("OK"))
})
通过中间件统一记录请求与响应
将日志逻辑封装成中间件，可以避免重复代码，并集中管理日志字段。
一个完整的日志中间件通常包含：
- 记录请求开始时间
- 捕获响应状态码（需包装ResponseWriter）
- 计算请求处理耗时
- 记录错误或panic（可结合recover）
包装ResponseWriter以获取状态码：
type responseWriter struct {
http.ResponseWriter
statusCode int
}
func (rw *responseWriter) WriteHeader(code int) {
rw.statusCode = code
rw.ResponseWriter.WriteHeader(code)
}
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
rw := &responseWriter{ResponseWriter: w, statusCode: 200}
start := time.Now()
next.ServeHTTP(rw, r)
slog.Info("请求完成",
"method", r.Method,
"path", r.URL.Path,
"status", rw.statusCode,
"duration_ms", time.Since(start).Milliseconds(),
"ip", r.RemoteAddr,
)
})
}
日志轮转与多输出管理
长时间运行的服务会产生大量日志，需通过轮转防止磁盘占满。
常用方案：
- 使用file-rotatelogs：配合zap或logrus实现按时间或大小轮转
- 结合系统工具：如Linux的logrotate定期切割日志文件
- 多输出配置：同时输出到文件和stderr，便于本地调试与容器环境采集
示例：zap + rotatelogs
import "github.com/lestrrat-go/file-rotatelogs"
writer, _ := rotatelogs.New(
"logs/access_%Y%m%d.log",
rotatelogs.WithMaxAge(7*24*time.Hour),
rotatelogs.WithRotationPeriod(24*time.Hour),
)
core := zapcore.NewCore(
zapcore.NewJSONEncoder(zap.NewProductionEncoderConfig()),
zapcore.AddSync(writer),
zap.InfoLevel,
)
logger := zap.New(core)
基本上就这些。从基础log到结构化输出，再到中间件封装和日志轮转，Golang提供了灵活的日志处理方式。选择合适的方法取决于项目规模、部署环境和运维要求。关键是保持日志内容清晰、结构一致，并确保不影响服务性能。
