Go log/slog 怎么给每条日志附加请求属性

在 HTTP 服务里，入口日志、鉴权日志和数据库错误如果没有同一个 request_id，排查一次请求往往要靠时间和关键词拼接。Go 的 log/slog 最直接的做法是在请求入口调用 Logger.With 创建派生 logger，把请求属性绑定到它，再把这个 logger 显式传给后续函数。这样每次记录都会自动带上固定字段，业务代码只补充当前事件的动态属性。

用 Logger.With 让请求字段沿调用链保持一致

请求开始时先决定哪些字段属于“整条请求”的稳定上下文，例如请求 ID、HTTP 方法和路径。不要在每次 Info 或 Error 调用里重复拼接，也不要在 handler 里调用 slog.SetDefault；后者会影响其他并发请求。

package main

import (
    "context"
    "log/slog"
    "net/http"
    "os"
)

type OrderService struct{}

func (s *OrderService) Load(ctx context.Context, logger *slog.Logger) {
    // 动态字段只描述当前业务事件，固定请求字段由派生 logger 自动补齐。
    logger.InfoContext(ctx, "load order", slog.String("result", "ok"))
}

func handleOrder(service *OrderService, base *slog.Logger) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        requestID := r.Header.Get("X-Request-ID")
        if requestID == "" {
            requestID = "generated-id"
        }

        // With 返回新 Logger，只在本次请求链路中附加这些属性。
        logger := base.With(
            slog.String("request_id", requestID),
            slog.String("method", r.Method),
            slog.String("path", r.URL.Path),
        )
        logger.InfoContext(r.Context(), "request started")
        service.Load(r.Context(), logger)
        logger.InfoContext(r.Context(), "request finished")
        w.WriteHeader(http.StatusNoContent)
    }
}

func main() {
    // JSONHandler 输出逐行 JSON，便于日志平台按字段检索。
    logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
    _ = handleOrder(&OrderService{}, logger)
}

这里的关键不是把 logger 塞进 context，而是让 service.Load 明确接收派生 logger。服务层因此不需要知道请求头的存在，也不会误用一个携带上一次请求属性的全局变量。生产代码里应把示例中的占位 ID 换成网关生成或服务端生成的真实请求 ID。

Handler、服务层和 JSONHandler 怎么分工

slog.Logger 负责创建记录并交给 Handler；TextHandler 适合人读，JSONHandler 适合采集系统。固定属性在 With 时绑定，当前事件的属性则放在日志调用里。这个分工能让同一组请求字段稳定出现，又不妨碍业务日志表达具体结果。

如果多个组件都使用 id、status 这类通用键，可以在派生 logger 上调用 WithGroup("request")。JSONHandler 会把它们放进 request 对象，避免和业务对象的同名字段混在一起。

requestLogger := slog.New(slog.NewJSONHandler(os.Stdout, nil)).WithGroup("request").With(
    // 这些字段属于请求上下文，不是某一条业务事件的临时结果。
    slog.String("id", requestID),
    slog.String("method", r.Method),
)

requestLogger.LogAttrs(r.Context(), slog.LevelInfo, "query finished",
    // LogAttrs 直接接收 Attr，适合已经准备好结构化字段的热路径。
    slog.Int64("duration_ms", elapsed.Milliseconds()),
    slog.Int("rows", rows),
)

LogAttrs 不会替你生成请求属性，它只是让当前调用直接传入 slog.Attr。若字段属于所有请求，放到 With；若只属于一次查询，留在 LogAttrs。边界清楚后，日志检索和采样规则都会更稳定。

常见问题

把 logger 放进 context 就能自动带属性吗？

不能。context 只保存值，slog 不会自动读取任意 context 键并把它们写成属性。可以用项目自己的 LoggerFromContext 辅助函数，但仍要明确存取约定。

每个请求都调用 slog.SetDefault 可以吗？

不可以。默认 logger 是进程级共享入口，请求级属性应通过 With 创建局部派生 logger，否则并发请求会互相覆盖或污染。

request_id 可以直接记录 Authorization 吗？

不可以。请求属性应只保留排障所需的非敏感标识；Cookie、Authorization、完整用户凭据和可复用令牌都应过滤或脱敏。