使用sync.Mutex可确保多goroutine下日志写入的并发安全,通过加锁保证同一时间只有一个goroutine写入;示例中safeLog函数使用mutex.Lock和defer mutex.Unlock实现原子操作;另一种方式是通过带缓冲channel集中日志写入,由单独goroutine消费,实现生产者-消费者模型,避免竞争;还可使用zap或logrus等第三方库,其内部已实现线程安全,如zap通过锁保护写操作,支持高性能结构化日志。

Go语言中没有传统意义上的“多线程”,而是使用goroutine和channel来实现并发。当日志被多个goroutine同时写入时,如果不加控制,可能导致日志内容交错、混乱甚至文件损坏。因此,处理多goroutine下的日志写入需要保证写操作的线程安全(并发安全)。
使用sync.Mutex保护日志写入
最常见的方式是使用sync.Mutex来确保同一时间只有一个goroutine能执行写日志的操作。
示例:
package mainimport ( "log" "os" "sync" )
var ( logFile *os.File mutex sync.Mutex )
func init() { var err error logFile, err = os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666) if err != nil { log.Fatal(err) } log.SetOutput(logFile) }
func safeLog(message string) { mutex.Lock() defer mutex.Unlock() log.Println(message) }
func main() { var wg sync.WaitGroup for i := 0; i < 10; i++ { wg.Add(1) go func(id int) { defer wg.Done() safeLog("来自 goroutine " + string(rune('0'+id))) }(i) } wg.Wait() logFile.Close() }
通过mutex.Lock()和defer mutex.Unlock(),我们确保了每次只允许一个goroutine写入日志,避免了数据竞争。
立即学习“go语言免费学习笔记(深入)”;
使用带缓冲的channel进行日志集中写入
另一种更优雅的方式是将所有日志消息发送到一个channel中,由单独的一个goroutine负责从channel读取并写入文件。这种方式实现了生产者-消费者模型,天然避免了并发冲突。
示例:
package mainimport ( "bufio" "os" )
var logChannel = make(chan string, 100)
func initLogger() { file, _ := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666) writer := bufio.NewWriter(file)
go func() { for msg := range logChannel { writer.WriteString(msg + "\n") writer.Flush() } writer.Flush() file.Close() }()}
func logAsync(message string) { select { case logChannel
func main() { initLogger() var wg sync.WaitGroup for i := 0; i
这种方式的优点是解耦了日志写入逻辑,性能更高,尤其适合高并发场景。
使用第三方日志库(如zap、logrus)
在实际项目中,推荐使用成熟的日志库,它们内部已经处理了并发安全问题。
- uber-go/zap:高性能结构化日志库,原生支持并发写入。
- Sirupsen/logrus:功能丰富,支持hook和多种输出格式,其写入操作也是线程安全的。
例如使用zap:
logger, _ := zap.NewProduction() defer logger.Sync()for i := 0; i < 10; i++ { go func(id int) { logger.Info("事件发生", zap.Int("id", id), zap.String("status", "done")) }(i) }
zap内部使用锁保护写操作,并且性能优秀,适合生产环境。
基本上就这些。无论选择哪种方式,关键是保证日志输出的原子性和顺序性,避免内容错乱。手动加锁简单直接,channel模式更灵活,第三方库则省心高效。










