使用zap等高性能结构化日志库，通过异步写入、分级输出、上下文标记和文件轮转，保障高并发下日志的完整性与系统稳定性。
在高并发服务中，日志是排查问题、监控系统状态的重要手段。Golang本身具备优秀的并发支持，但若不加控制地进行日志写入，容易引发性能瓶颈或输出混乱。合理的日志记录与输出控制机制，不仅能保证信息的完整性，还能提升系统稳定性。
使用结构化日志库（如 zap 或 zerolog）
标准库 log 包功能简单，在高并发场景下性能不足。推荐使用高性能结构化日志库：
- uber-go/zap：专为性能设计，支持结构化日志，适合生产环境
- rs/zerolog：零内存分配设计，性能极高，输出 JSON 格式
以 zap 为例，初始化一个可并发安全使用的 logger：
logger, _ := zap.NewProduction()defer logger.Sync() // 确保所有日志写入磁盘
在多个 goroutine 中直接调用 logger.Info()、logger.Error() 是安全的，底层已做同步处理。
立即学习“go语言免费学习笔记（深入）”；
避免日志竞争与性能损耗
尽管结构化日志库线程安全，但大量并发写入仍可能成为瓶颈。可通过以下方式优化：
- 使用异步日志写入：zap 支持通过缓冲队列将日志写入操作异步化
- 限制日志频率：对高频事件采用采样策略，例如每秒最多记录一次特定类型的日志
- 分级输出：调试日志仅在开发环境开启，生产环境使用 Info 及以上级别
配置 zap 的异步模式示例：
cfg := zap.NewProductionConfig()
cfg.Level = zap.NewAtomicLevelAt(zap.InfoLevel)
cfg.OutputPaths = []string{"stdout", "/var/log/app.log"}
logger, _ := cfg.Build()
按模块或上下文分离日志输出
大型系统中，不同业务模块的日志混杂会增加排查难度。建议通过字段标记来源：
- 使用 With 方法附加上下文，如请求 ID、用户 ID、模块名
- HTTP 请求中可在中间件注入 request_id，贯穿整个调用链
示例：
requestLogger := logger.With(zap.String("req_id", "abc123"),
zap.String("module", "auth")
)
requestLogger.Info("user login failed")
输出将包含上下文信息，便于后续检索与分析。
控制日志文件大小与轮转
长时间运行的服务会产生大量日志，需结合外部工具或库实现轮转：
- 使用 lumberjack 配合 zap 实现按大小切分日志文件
- 设置最大保留份数，防止磁盘占满
zap + lumberjack 配置示例：
writeSyncer := zapcore.AddSync(&lumberjack.Logger{Filename: "/var/log/app.log",
MaxSize: 10, // MB
MaxBackups: 5,
MaxAge: 7, // 天
})
core := zapcore.NewCore(..., writeSyncer, ...)
logger := zap.New(core)
基本上就这些。合理选型日志库、控制输出节奏、附加上下文信息、管理日志生命周期，才能在并发场景下做到可观测性与性能兼顾。
