Go多协程写日志至文件触发死锁，求推荐易用日志库

死锁原因分析 #

1. 递归锁触发死锁（logrus场景）
   logrus的Logger内部默认通过MutexWrap保证并发安全，若你在日志钩子（如lfshook）的处理逻辑中再次调用日志输出方法，会出现同一goroutine递归请求锁的情况，直接触发死锁。从第二个栈信息看，goroutine卡在logrus.(*MutexWrap).Lock，完全符合递归锁死锁的特征。

2. 文件描述符锁阻塞（zap/rotatelogs场景）
   第一个栈显示卡在internal/poll.(*fdMutex).rwlock，这是Go标准库对文件描述符的读写保护锁。出现该问题的核心原因：

   • rotatelogs执行日志切割时，会关闭旧文件、创建新文件，这个过程若与goroutine的写入操作并发执行，可能形成fd锁的持有等待链，最终导致死锁；
   • 若磁盘满、文件系统出错等导致IO阻塞，持有fd锁的goroutine无法释放锁，其他写入goroutine会持续等待，表现为死锁。

3. 跨日志库的共性问题
   换zap仍出现死锁，说明问题不在日志库本身，而是文件写入层的并发处理逻辑缺陷或日志切割工具的线程安全问题。比如rotatelogs的Writer若未实现完整的并发安全，多goroutine写入时会导致底层fd的锁竞争升级为死锁。

推荐Go日志库 #

• zap（优化使用方式）：zap本身性能极高且线程安全，出现死锁大概率是搭配的rotatelogs或自定义writer有问题。可改用zap官方推荐的zapcore.AddSync包装writer，或用成熟的lumberjack替代rotatelogs，避免fd操作的并发冲突。
• zerolog：轻量无锁设计（默认通过channel异步写入），天生适配高并发场景，API简洁，支持日志切割、结构化输出，几乎不会出现锁相关死锁。
• logrus（修复使用方式）：若坚持使用logrus，需确保钩子中不会递归调用日志方法，同时用sync.Mutex包装rotatelogs的writer后再传入lfshook，保证并发写入的线程安全。

内容的提问来源于stack exchange，提问作者dtdyq