跳转到主内容
趣航编程网 - 趣学编程,启航技术之路!

golang如何实现日志按级别过滤_golang日志按级别过滤实现教程

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语言免费学习笔记(深入) ”; 示例核心逻辑:
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")
vs
zerolog.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
,数值越大级别越高,别用
<
写反了。

相关文章