当前位置：首页 > 文章列表 > Golang > Go教程 > Golang并发日志技巧与goroutine记录方法

Golang并发日志技巧与goroutine记录方法

2026-01-25 16:22:15 0浏览收藏

在IT行业这个发展更新速度很快的行业，只有不停止的学习，才不会被行业所淘汰。如果你是Golang学习者，那么本文《Golang并发日志写入技巧与goroutine记录方法》就很适合你！本篇内容主要包括##content_title##，希望对大家的知识积累有所帮助，助力实战开发！

直接用 log.Printf 在多 goroutine 中写文件会出问题，因为 log.Logger 默认不并发安全，格式化与写入非原子操作，易致日志错乱、截断或 panic。

如何使用Golang实现并发日志写入_Golang多goroutine日志记录方法

为什么直接用 `log.Printf` 在多 goroutine 中写文件会出问题

因为标准库的 log.Logger 默认不保证并发安全——多个 goroutine 同时调用 logger.Print() 可能导致日志行错乱、截断，甚至 panic（比如底层 os.File.Write 被并发调用时触发内部锁竞争或缓冲区越界）。这不是“偶尔出错”，而是在高并发写入场景下几乎必然发生。

典型现象：2024-05-12T10:23:41Z INFO user login 和 2024-05-12T10:23:41Z ERROR db timeout 混合成一行，如 2024-05-12T10:23:41Z INFO user login2024-05-12T10:23:41Z ERROR db timeout
根本原因：日志格式化 + 写入不是原子操作；log.Logger 的 Output 方法内部未对写入目标加锁
误区：以为给 log.New 传一个带互斥锁的 io.Writer 就够了——其实还不够，因为格式化字符串（含时间、调用栈）本身也需同步，否则不同 goroutine 的 runtime.Caller 信息可能交叉

用 `sync.Mutex` 包裹 `log.Logger` 是最简方案但有性能瓶颈

适用于 QPS

var (
    mu     sync.Mutex
    logger = log.New(os.Stdout, "", log.LstdFlags)
)
func SafeLog(msg string) {
mu.Lock()
defer mu.Unlock()
logger.Println(msg)
}

不要在 log.New 里直接传 &muWriter{mu: &mu, w: file} 这类包装 writer——log.Logger 会在每次调用时重置缓冲区并多次调用 Write，仅锁 Write 无法防止格式化内容被其他 goroutine 插入
如果必须用标准库，务必把整个 logger.Println 或 logger.Printf 调用包在 Lock/Unlock 内
注意：log.SetOutput 不是并发安全的，不能在运行时动态切换输出目标