slog 默认不支持级别过滤,需自定义 Handler 实现:通过 LevelFilterHandler 包装标准 Handler,在 Handle 方法中判断 rec.Level >= minLevel 决定是否输出。

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

















