采用同步或集中式处理确保日志写入安全,通过互斥锁、通道协程或第三方库如zap实现高并发下日志的原子性与顺序性,避免资源竞争。

在高并发场景下,多个Goroutine同时写日志容易引发数据错乱、文件损坏或性能瓶颈。Golang本身没有内置的线程安全日志机制,因此需要手动设计合理的方案来避免并发冲突。核心思路是通过同步机制或集中式处理确保日志写入的原子性和顺序性。
使用互斥锁保护日志写入
最直接的方式是用sync.Mutex包裹日志输出操作,确保同一时间只有一个Goroutine能写日志。
示例:
var logMutex sync.Mutex var logFile *os.Filefunc safeLog(message string) { logMutex.Lock() defer logMutex.Unlock() logFile.WriteString(message + "\n") }
这种方式简单有效,适合低频日志场景。但在高并发下可能成为性能瓶颈,因为所有写操作都要排队。
立即学习“go语言免费学习笔记(深入)”;
采用通道集中式日志处理
更优雅的做法是启动一个专用的日志协程,其他协程通过通道发送日志消息,实现解耦和异步写入。
实现方式:
- 定义日志消息结构体,包含内容、级别、时间等字段
- 创建缓冲通道作为日志队列
- 启动单个消费者协程从通道读取并写入文件
代码片段:
type LogEntry struct {
Message string
Level string
}
var logChan = make(chan LogEntry, 1000)
func init() {
go func() {
for entry := range logChan {
logFile.WriteString(
fmt.Sprintf("[%s] %s: %s\n",
time.Now().Format("2006-01-02 15:04:05"),
entry.Level,
entry.Message))
}
}()
}
func Info(msg string) {
logChan <- LogEntry{Message: msg, Level: "INFO"}
}
这种模式提升了并发性能,还能方便地做日志缓冲、批量写入和错误重试。
借助第三方日志库简化处理
实际项目中推荐使用成熟的日志库,它们已内置并发安全机制。
常用选择:
- zap(Uber开源):高性能结构化日志,原生支持并发写入
- logrus:功能丰富,可通过Hook机制实现线程安全输出
- slog(Go 1.21+):官方结构化日志包,默认线程安全
以zap为例:
logger, _ := zap.NewProduction() defer logger.Sync()go func() { logger.Info("并发日志测试") }() go func() { logger.Error("另一个协程写日志") }()
zap内部使用了无锁队列和对象池,能在高并发下保持稳定性能。
基本上就这些。关键是要避免多个协程直接操作同一个IO资源。用锁最简单,用通道更灵活,用现成库最省心。根据项目复杂度选择合适方案即可。










