Go slog.Handler 如何按请求动态降噪：日志级别与上下文字段的取舍

线上服务接入 log/slog 后，日志很快会遇到一个现实问题：健康检查每几秒打一行，普通请求又带着一串重复字段，真正的错误反而被淹没。比较稳妥的做法不是把某个包整体调成静默，而是让自定义 slog.Handler 根据请求属性决定是否记录，并固定保留能串起一次请求的诊断字段。

先把三类请求分开，别用一个全局级别硬压

以一个 HTTP 服务为例，/healthz 的访问频率高但诊断价值低，普通业务请求需要知道状态码和耗时，失败请求则必须留下错误链。三种请求适合的门槛不同：

这里的“动态”指请求上下文参与判断，而不是运行时随意修改全局日志配置。全局配置只负责最大允许级别，单次请求再决定是否值得输出。

Enabled 和 Handle 各做一件事

slog.Handler 的两个关键入口不要混用。Enabled 回答“这个级别在当前上下文是否值得处理”，适合做轻量判断；Handle 接收已经形成的 slog.Record，适合清理字段、补充请求属性，再交给下游 Handler。

type requestKey struct{}

type RequestInfo struct {
    ID     string
    Route  string
    Status int
}

type RequestHandler struct {
    next slog.Handler
}

func (h *RequestHandler) Enabled(ctx context.Context, level slog.Level) bool {
    info, _ := ctx.Value(requestKey{}).(RequestInfo)
    if info.Route == "/healthz" {
        return level >= slog.LevelDebug
    }
    return level >= slog.LevelInfo
}

func (h *RequestHandler) Handle(ctx context.Context, record slog.Record) error {
    info, _ := ctx.Value(requestKey{}).(RequestInfo)
    if info.ID != "" {
        record.AddAttrs(slog.String("request_id", info.ID))
    }
    if info.Route != "" {
        record.AddAttrs(slog.String("route", info.Route))
    }
    if info.Status != 0 {
        record.AddAttrs(slog.Int("status", info.Status))
    }
    return h.next.Handle(ctx, record)
}

示例刻意只放了稳定的请求信息。不要把可变的 map 直接挂进 Handler，也不要在 Handle 里修改共享配置；服务启动时构造好 next，请求级值通过 Context 传入。

字段保留应服务于一次排障

日志降噪最容易犯的错是只删字段，不定义“删完以后要回答什么”。如果问题是“哪个请求在支付接口失败”，至少要有 request_id、route、status、duration_ms 和 err。用户手机号、完整请求体和 Authorization 之类敏感信息则不应该因为排查方便而原样写入。

可以让业务日志使用固定字段名，再由 Handler 过滤明显的高风险属性：

func safeAttr(attr slog.Attr) bool {
    switch attr.Key {
    case "authorization", "password", "raw_body":
        return false
    default:
        return true
    }
}

func keepDiagnostic(record slog.Record) slog.Record {
    var attrs []slog.Attr
    record.Attrs(func(attr slog.Attr) bool {
        if safeAttr(attr) {
            attrs = append(attrs, attr)
        }
        return true
    })
    return record
}

实际项目中可以把过滤放到一个包装 Handler 里，但要明确它只做字段策略，不改变日志级别语义。错误级别的记录即使被裁剪，也应留下可关联的 ID 和错误类别。

三种方案怎么选

如果只是想固定调低某个环境的日志量，直接使用 slog.LevelVar 更简单；如果需要按请求判断健康检查、错误和采样规则，再包一层 Handler；如果日志需要送到多个目的地，建议把“字段清理”和“输出路由”拆成两个职责清楚的 Handler，避免一个类型同时维护太多状态。

一个实用的顺序是：先过滤敏感字段，再做动态级别判断，最后交给 JSON Handler。若团队更重视故障检索，也可以把错误分类字段在业务层明确传入，避免 Handler 猜测错误含义。

并发、采样和测试边界

标准库 Handler 可能被多个 goroutine 同时调用，因此不要在 Handle 中复用可变的临时切片或修改共享的 RequestInfo。需要采样时，使用独立的并发安全随机源或按 request_id 做稳定采样；不要让同一个请求在重试时一会儿被采样、一会儿被丢弃。

测试至少覆盖四个判断：健康检查在 INFO 下是否被抑制；失败请求是否留下 request_id；敏感字段是否被移除；并发请求之间是否发生字段串线。用 httptest 发起并发请求，再把 JSON 日志解析回结构体，比只比较字符串更可靠。

func TestRequestHandlerKeepsErrorContext(t *testing.T) {
    ctx := context.WithValue(context.Background(), requestKey{}, RequestInfo{
        ID: "req-42", Route: "/pay", Status: 500,
    })
    h := &RequestHandler{next: slog.NewJSONHandler(io.Discard, nil)}
    if !h.Enabled(ctx, slog.LevelError) {
        t.Fatal("error record must stay enabled")
    }
}

常见问题

只改 slog.LevelVar 能按 URL 降噪吗？

不能。LevelVar 适合统一级别；按 URL、状态码或 Context 判断，需要在 Handler 层实现。

应该在 Enabled 里读取请求体吗？

不应该。Enabled 应保持轻量，读取请求体会增加开销，也会让日志判断产生不易预期的副作用。

错误日志被过滤后怎么关联请求？

把 request_id 在中间件进入 Context 时生成，并在 Handle 中作为稳定字段补回；不要依赖日志文本里的自然语言。

自定义 Handler 是否需要锁？

只有在 Handler 自己维护可变共享状态时才需要同步。更好的边界是启动时固定配置，请求状态放入 Context，并通过测试验证并发安全。

收尾检查

动态降噪的判断标准很简单：低价值的重复事件少一点，真正的错误线索不能少。把 Enabled 控制在轻量判断范围，把 Handle 用于字段补齐和清理，再用四组并发测试确认请求之间没有串线，通常就能在日志量和可诊断性之间取得稳定平衡。