Go标准库log包不支持中间件内动态多输出,因log.SetOutput仅接受单个io.Writer且全局覆盖;必须在main初始化时用io.MultiWriter组合目标并一次性设置,且无法分级路由。

Go HTTP 中间件里用标准 log 包无法直接支持多输出
标准 log 包的 log.SetOutput 只接受单个 io.Writer,中间件里调一次就覆盖全局输出目标。你不能在中间件里反复调 log.SetOutput 来“切换”目的地,否则会干扰其他 goroutine 的日志行为,甚至丢失日志。
必须用 io.MultiWriter 组合输出目标,且要在中间件外初始化
中间件本身不负责创建或管理日志 writer,它只负责调用日志函数。真正要支持「控制台 + 文件」双写,得在 main() 或初始化阶段完成 writer 构建:
- 用
os.OpenFile(..., os.O_CREATE|os.O_APPEND|os.O_WRONLY, 0644)打开日志文件,别用os.O_RDWR - 用
io.MultiWriter(os.Stdout, file)合成一个 writer - 在任何 handler 或中间件运行前,仅调一次
log.SetOutput(multiWriter) - 中间件里直接用
log.Printf("req: %s %s", r.Method, r.URL.Path)即可,输出自动分发
想按级别分流(如 error 写文件、info 打屏),标准 log 不行
标准 log 没有内置级别概念,log.Println 和 log.Printf 全部走同一输出流。即使你用了 io.MultiWriter,error 和 info 也会同时出现在终端和文件里——这不是 bug,是设计如此。
若需真正分级路由,必须换结构化日志库,并在中间件中使用其 logger 实例:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
-
zap.New(zapcore.NewTee(core1, core2)):一个core绑文件 +zapcore.ErrorLevel,另一个绑os.Stdout+zapcore.InfoLevel -
logrus.AddHook配合自定义 hook,在Fired()里判断entry.Level再决定是否写入文件 - 中间件中持有该 logger 实例(如通过
context.WithValue或全局变量),避免每次新建
中间件里日志写入失败,通常是因为文件 writer 未正确关闭或权限不足
常见静默失败点:
- 忘记
defer file.Close(),程序退出后文件句柄泄漏,后续写入可能被内核拒绝 - 日志目录不存在,
os.OpenFile不会自动创建父目录,要用os.MkdirAll(filepath.Dir(logPath), 0755)预置 - Linux 下以非 root 用户启动服务,但日志路径在
/var/log/等受限目录,导致open /var/log/app.log: permission denied - 多实例部署时共用同一日志文件,但没加文件锁,可能引发内容错乱(
zapcore.Lock或flock可缓解)
这些都不是中间件逻辑的问题,而是底层 writer 初始化阶段就该兜底的细节。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










