因为log.SetOutput仅支持单个io.Writer,无法动态切换、组合或按级别分流日志;真正可插拔需定义Handler接口,通过MultiHandler实现运行时增删处理器,各handler专注投递、不耦合格式化,且须统一LogRecord字段语义。

为什么不能直接用 log.SetOutput?
因为 log.SetOutput 只接受一个 io.Writer,没法动态切换、组合或条件路由日志——比如开发时输出到控制台,上线后同时写文件 + 发 HTTP;或者按 level 分流到不同后端。它本质是单点绑定,不是插拔式设计。
真正可插拔,得让日志“经过”一组可增删的处理器(handler),每个 handler 决定是否处理、怎么处理、是否继续传递。
- 别把日志格式化逻辑和输出逻辑耦合在同一个地方
- 每个后端应实现统一接口,比如
Handle(*LogRecord),而不是各自写WriteString或PostJSON - 避免全局变量污染:不要用
var GlobalHandler Handler,改用显式传入或依赖注入
定义可组合的 Handler 接口
Go 标准库没有内置 handler 概念,所以得自己定义轻量接口。关键是让它支持链式调用和条件中断:
type LogRecord struct {
Time time.Time
Level string
Msg string
Fields map[string]interface{}
}
type Handler interface {
Handle(*LogRecord) error // 返回非 nil 表示处理失败,但不强制中断链
}
type HandlerFunc func(*LogRecord) error
func (f HandlerFunc) Handle(r *LogRecord) error { return f(r) }
这样你就能写 ConsoleHandler、FileHandler、HTTPHandler 各自独立实现 Handle,互不影响。
- 返回
error是为了便于调试失败(比如文件满、API 限流),但不建议用它控制流程(如“跳过后续 handler”) - 若需条件分流(如只让
Warn以上进 Slack),在 handler 内部判断,别靠 error 传递语义 - 别让
Handle做格式化——格式化应由上层(logger)完成,handler 只负责“投递”
用 MultiHandler 实现运行时插拔
核心是把多个 Handler 装进一个切片,遍历时允许动态增删。注意:增删操作本身不是并发安全的,所以要么初始化后固定,要么加锁:
type MultiHandler struct {
handlers []Handler
mu sync.RWMutex
}
func (m *MultiHandler) Add(h Handler) {
m.mu.Lock()
defer m.mu.Unlock()
m.handlers = append(m.handlers, h)
}
func (m *MultiHandler) Handle(r *LogRecord) error {
m.mu.RLock()
defer m.mu.RUnlock()
for _, h := range m.handlers {
if err := h.Handle(r); err != nil {
// 记录 handler 失败,但不中断其他 handler
_ = ConsoleHandler{}.Handle(&LogRecord{
Level: "ERROR",
Msg: "handler failed",
Fields: map[string]interface{}{"err": err},
})
}
}
return nil
}
- 添加新后端只需调用
multi.Add(&SlackHandler{...}),无需重启服务 - 删除更谨慎:生产环境一般不删,而是用 wrapper 控制开关(比如
ToggleHandler) - 别在
Handle里做耗时操作(如同步 HTTP 请求),否则会拖慢所有日志;加 goroutine 要小心 panic 捕获和资源泄漏
与标准 log 或 zap 集成时的关键适配点
标准 log.Logger 只认 io.Writer,所以你需要一个桥接器:
type WriterAdapter struct {
handler Handler
}
func (w WriterAdapter) Write(p []byte) (int, error) {
// 粗略解析:实际项目中应避免这种解析,改用结构化日志入口
record := &LogRecord{
Time: time.Now(),
Level: "INFO",
Msg: string(p),
}
_ = w.handler.Handle(record)
return len(p), nil
}
log.SetOutput(WriterAdapter{multi})
但更推荐绕过标准 log,直接用结构化 logger(如 zap)+ 自定义 Core,因为:
-
zap.Core的WriteEntry方法天然接收结构化数据,不用 hack 解析字符串 -
zap支持WrapCore,可以无侵入地插入预处理或后端路由逻辑 - 标准
log没有 level、field 概念,强行塞进去会导致信息丢失或误判
真正难的不是写几个 handler,而是确保每个 handler 对 LogRecord 字段的解释一致(比如 Fields["trace_id"] 到处都当字符串用,而不是有时是 int64 有时是 string)。这个契约一旦松动,插拔就变成埋雷。


















