当前位置：首页 > 文章列表 > Golang > Go教程 > Go slog 如何按级别过滤日志：HandlerOptions、日志级别与测试验证

Go slog 如何按级别过滤日志：HandlerOptions、日志级别与测试验证

来源：17golang原创 2026-08-24 20:42:28 0浏览收藏

线上服务把日志切到结构化格式后，最常见的下一步不是换日志库，而是先把“哪些级别应该落盘”定下来。Go 的 log/slog 可以在创建 Handler 时设置最低级别：例如生产环境只输出 INFO 及以上，排查问题时再用 LevelVar 动态放开 DEBUG。

HandlerOptions{Level: slog.LevelInfo} 会过滤 DEBUG；如果运行中需要调整级别，就把它换成可并发读写的 slog.LevelVar，并用测试缓冲区确认实际输出。

要点速览：

固定 slog.Level 适合配置稳定的进程。
LevelVar 适合临时排障，并支持运行中调整。
过滤发生在 Handler 的启用判断阶段，被过滤的日志不会继续写出。

先把“最低级别”与日志调用分开看

slog.Level 是表示严重程度的整数，数值越高越严重。内置的 INFO、WARN、ERROR 和 DEBUG 只是常用档位。Handler 的最低级别不是“只允许一种级别”，而是允许该级别及更严重的记录通过。

package main

import (
    "os"
    "log/slog"
)

func main() {
    handler := slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
        Level: slog.LevelInfo,
    })
    logger := slog.New(handler)

    logger.Debug("cache probe", "key", "user:42")
    logger.Info("request accepted", "status", 200)
    logger.Error("request failed", "status", 500)
}

运行后可以看到 INFO 和 ERROR，DEBUG 不会出现在 JSON 输出中。这里不要把 Level 理解成“日志调用开关”；它决定的是 Handler 是否启用某个级别。

固定级别的完整工作流：创建、记录、核对

Go slog 固定最低级别的 Handler 流程，展示 DEBUG 被过滤而 INFO 和 ERROR 通过

第一步先选择输出格式。NewTextHandler 适合人直接查看，NewJSONHandler 适合采集系统逐行解析。第二步把最低级别放进 HandlerOptions，第三步在相同输出目标上核对结果。

var level = slog.LevelInfo

handler := slog.NewTextHandler(os.Stderr, &slog.HandlerOptions{
    Level:     level,
    AddSource: true,
})
logger := slog.New(handler)
logger.Info("worker started", "queue", "emails")

AddSource 只负责附加调用位置，不改变级别过滤。生产配置通常不需要为了“看见更多日志”而打开源码位置；先确认采集端真正缺的是级别还是字段。

需要临时排障时，用 LevelVar 调整而不是重建 Handler

固定的 slog.Level 会在 Handler 生命周期内保持不变。若希望管理员开关或诊断接口改变级别，可使用 LevelVar：

var programLevel slog.LevelVar // 默认是 INFO

func newLogger() *slog.Logger {
    h := slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
        Level: &programLevel,
    })
    return slog.New(h)
}

func enableDebug() {
    programLevel.Set(slog.LevelDebug)
}

LevelVar 适合多个 goroutine 读取、单点修改的配置。它不是让所有请求都永久输出 DEBUG 的理由：打开后应有明确的关闭路径，并注意敏感字段可能随调试日志暴露。

用缓冲区测试过滤结果，而不是凭肉眼猜

Go slog 使用 bytes.Buffer 验证 DEBUG 过滤与 LevelVar 动态切换

测试时可以把 JSON Handler 的输出写入 bytes.Buffer，分别记录 DEBUG 和 INFO，再检查文本中是否出现预期消息。这个测试验证的是完整链路：调用级别、Handler 的 Enabled 判断以及最终编码。

func TestLogLevel(t *testing.T) {
    var buf bytes.Buffer
    var level slog.LevelVar
    level.Set(slog.LevelInfo)

    logger := slog.New(slog.NewJSONHandler(&buf, &slog.HandlerOptions{
        Level: &level,
    }))
    logger.Debug("hidden")
    logger.Info("visible")

    got := buf.String()
    if strings.Contains(got, "hidden") {
        t.Fatal("debug record should be filtered")
    }
    if !strings.Contains(got, "visible") {
        t.Fatal("info record should be written")
    }

    level.Set(slog.LevelDebug)
    logger.Debug("now-visible")
    if !strings.Contains(buf.String(), "now-visible") {
        t.Fatal("debug record should be enabled after level change")
    }
}

测试里最好检查稳定的消息字段，不要把时间戳、源码行号或 JSON 字段顺序当成断言重点。若只断言“缓冲区非空”，就无法证明 DEBUG 确实被拦截。