slog 默认不支持级别过滤,需自定义 Handler 实现:通过 LevelFilterHandler 包装标准 Handler,在 Handle 方法中判断 rec.Level >= minLevel 决定是否输出。
log/slog 默认不支持级别过滤,得自己加 Handler
Go 1.21+ 的
包本身没有内置「只输出 ERROR 以上」这种开关。它的
接口只负责格式化和写入,过滤逻辑必须手动实现——不是配置项,是代码逻辑。
常见错误现象:
这样写没用,
方法调用时日志级别已固定为
,不会被前面的
改变。
真正起作用的是
实现里的
方法,它会收到每条日志的
是当前日志的真实级别,比如
或
你得在
里判断
,不满足就直接 return
用 slog.NewTextHandler + 自定义 FilterHandler 最轻量
别去魔改
返回的对象(它没暴露内部结构),而是包一层自己的
。这样既复用标准格式化逻辑,又控制输出权限。
使用场景:CLI 工具、微服务调试阶段需要快速切日志粒度,又不想引入 zap/logrus 等重型库。
立即学习
“
go语言免费学习笔记(深入)
”;
示例核心逻辑:
设为
就只输出 Warn/Err
可以是
,不影响过滤逻辑
注意:这个 handler 不是线程安全的,但
本身是,所以直接用
包装即可
第三方库如 zerolog/zap 的 level 控制更直观,但代价是侵入性
如果你已经在用
,
一行搞定;
也类似,
配
即可。
但换库不是零成本:
所有
/
调用要改成对应库的 API,比如
自定义字段写法不同:
vs
如果项目已用
做了大量封装(比如统一 logger 构建函数),切换反而增加维护负担
环境变量控制 level 时,slog.Level.UnmarshalText 是关键转换点
想通过
启动时动态设级别?别手写字符串 switch,
实现了
,能直接解析
/
等字符串。
常见错误:用
判断,漏掉大小写容错或未知值处理。
正确做法:
失败时
保持默认值(
),可额外加 fallback 提示
注意:
对应字符串是
(全大写),不是
级别过滤这事,核心就两行:判断
和决定是否继续传递给下层 handler。容易被忽略的是——slog 的 level 是有符号整数,
,
,数值越大级别越高,别用
写反了。
slogslog.Handlerslog.With("level", slog.LevelError).Info("msg")Infoslog.LevelInfoWithHandlerHandleslog.RecordRecord.Levelslog.LevelErrorslog.LevelDebugHandler.Level >= minLevelslog.NewTextHandlerHandlertype LevelFilterHandler struct {
minLevel slog.Level
inner slog.Handler
}
func (h LevelFilterHandler) Handle(r context.Context, rec slog.Record) error {
if rec.Level < h.minLevel {
return nil // 直接丢弃,不传给 inner
}
return h.inner.Handle(r, rec)
}
logger := slog.New(LevelFilterHandler{
minLevel: slog.LevelError,
inner: slog.NewTextHandler(os.Stdout, nil),
})minLevelslog.LevelWarninnerslog.NewJSONHandlerslog.Loggerslog.Newzerologzerolog.SetGlobalLevel(zerolog.WarnLevel)zapzap.LevelEnablerFuncConfigslog.Infoslog.Errorlogger.Info().Msg("xxx")slog.String("key", "val")zerolog.Str("key", "val")slogLOG_LEVEL=errorslog.LevelUnmarshalText"debug""error"strings.ToLower(os.Getenv("LOG_LEVEL")) == "error"var l slog.Level; l.UnmarshalText([]byte(os.Getenv("LOG_LEVEL")))lslog.LevelInfoslog.LevelDebug"DEBUG""debug"rec.LevelLevelDebug = -4LevelError = 12<