Golang日志过滤级别实现详解

Go 1.21+ 的标准日志包 `log/slog` 虽简洁轻量，但默认不支持按级别（如仅输出 ERROR 及以上）过滤日志，必须通过自定义 `Handler` 实现——核心逻辑仅需在 `Handle` 方法中比较 `rec.Level >= minLevel` 并决定是否转发给底层处理器；文章详解了如何用 `LevelFilterHandler` 包装 `slog.NewTextHandler` 或 `NewJSONHandler` 实现零依赖、低侵入的级别控制，澄清了常见误区（如 `With("level", ...)` 无效、`slog.Level` 是有符号整数且数值越大级别越高），并对比了第三方库方案的取舍，还提供了通过环境变量（借助 `UnmarshalText` 安全解析）动态配置级别的最佳实践，是 Golang 开发者在保持标准库简洁性的同时精准掌控日志输出的实用指南。

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 等重型库。

示例核心逻辑：

type LevelFilterHandler struct {
	minLevel slog.Level
	inner    slog.Handler
}

func (h LevelFilterHandler) Handle(r context.Context, rec slog.Record) error {
	if rec.Level 

• 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，数值越大级别越高，别用 < 写反了。

到这里，我们也就讲完了《Golang日志过滤级别实现详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！