Go slog.HandlerEnabled 怎么做动态日志级别：LevelVar 与请求级过滤边界

线上服务把默认日志级别设成 INFO 后，临时想打开某个请求的 DEBUG 细节，最容易踩的坑是把“是否记录”与“记录哪些属性”混成一件事。log/slog 的 HandlerEnabled 可以先回答级别是否开启，LevelVar 则让这个答案在运行中可调整；请求级过滤仍然要在 Handle 附近明确处理。

用 LevelVar 管全局或组件级阈值，用 HandlerEnabled 做便宜的前置判断；需要按请求筛选时，把规则放进 context.Context 与 Handle 的处理链，不要指望 LevelVar 识别请求。

HandlerEnabled 先解决“这条日志要不要做”

slog.HandlerEnabled 接收 context.Context 和 slog.Level，它的价值不在于改变日志内容，而在于让调用方在构造昂贵参数之前知道这条记录是否可能被处理。比如要计算一段 SQL 摘要，先判断 DEBUG 是否打开，能避免无用字符串拼接。

var levelVar slog.LevelVar
levelVar.Set(slog.LevelInfo)

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

ctx := context.Background()
if logger.Enabled(ctx, slog.LevelDebug) {
    logger.DebugContext(ctx, "query plan", "table", "orders")
}

这里的调用链很短：Logger 把判断转给 HandlerEnabled，阈值来自 LevelVar，最终与 slog.Level 比较。INFO 阈值下，DEBUG 不会进入后续处理；把阈值改成 DEBUG 后，同一判断才会放行。

LevelVar 适合动态调级，不等于请求级开关

运行中的配置端点可以调用 levelVar.Set(slog.LevelDebug) 临时放宽阈值，排查结束后再设回 INFO。这个变量描述的是共享策略：同一个 Handler 下，所有经过它的记录都看到同一个当前级别。

如果需求是“只让带 debug 请求头的请求多打日志”，就不要修改共享的 LevelVar。共享阈值会把其他请求一起放大，反而制造噪声。更稳的边界是把请求标记放进 context.Context，让 Handle 结合级别和上下文做二次判断。

type requestDebugKey struct{}

func withRequestDebug(ctx context.Context, enabled bool) context.Context {
    return context.WithValue(ctx, requestDebugKey{}, enabled)
}

func requestDebug(ctx context.Context) bool {
    enabled, _ := ctx.Value(requestDebugKey{}).(bool)
    return enabled
}

自定义 Handler 时，Handle 可以先检查 requestDebug(ctx)，再决定是否继续写出记录。需要注意：上下文值只适合表达当前请求的短生命周期信号，不要把它当成跨请求配置中心。

昂贵字段应该放在 Enabled 判断之后

很多代码虽然调用了 DEBUG 日志，却先执行了昂贵的序列化：

payload := buildLargePayload(order)
logger.DebugContext(ctx, "order payload", "payload", payload)

更合适的顺序是先问 logger.Enabled(ctx, slog.LevelDebug)，通过后再构造 payload。这不是为了让 DEBUG 变得更“高级”，而是把 CPU 和内存开销放在确定会用到它的分支里。

三个容易误判的边界

• 改了 LevelVar 但没有日志：先确认记录级别和 Handler 的 Level 配置是否真的使用了同一个 LevelVar。
• 请求级标记影响了所有请求：检查是否错误地调用了共享 levelVar.Set，而不是只在上下文中传递标记。
• Enabled 判断通过却仍然丢字段：检查自定义 Handler 的 Handle 是否又做了一次属性或上下文过滤。

相关问题

LevelVar 能不能替代配置中心？

不能。它只提供进程内的并发安全级别变量；多实例服务仍需要各实例独立接收配置并记录变更。

HandlerEnabled 会不会把日志写出去？

不会。它只是判断，真正写出发生在后续的 Handle 流程。

请求级 DEBUG 是否适合直接改全局级别？

通常不适合。全局调级会放大所有请求，短时排障应优先使用上下文标记和明确的过期机制。

把判断边界留在调用链里

把 LevelVar 当作共享阈值，把 HandlerEnabled 当作前置判断，把 context.Context 和 Handle 留给请求级规则，日志系统就能同时做到可调级和可控噪声。上线前至少验证一次 DEBUG 关闭、共享调级、单请求调试和恢复 INFO 四种状态。