当前位置：首页 > 文章列表 > Golang > Go教程 > Go slog 生产实践：日志别只会打印 error，要能帮你排障

Go slog 生产实践：日志别只会打印 error，要能帮你排障

来源：Go 官方博客与近期 slog 生产实践资料参考，17golang 原创解读 2026-06-01 19:46:42 0浏览收藏

很多 Go 服务不是没有日志，而是日志没法用：一堆 log.Println(err)，线上真出事时，你搜不到 request_id，看不到用户、订单、下游、耗时，也不知道这条 error 到底该告警还是只是业务拒绝。Go 标准库里的 log/slog，真正值得用的地方不是“换个 logger”，而是让日志变成可查询、可聚合、可关联的结构化事件。

这篇按我做线上服务的习惯聊，不堆 API 清单。我们重点看：字段怎么设计，context 里放什么，错误怎么打，敏感信息怎么脱敏，最后怎么让日志和 trace、metrics 对得上。

Go slog 生产结构化日志思维导图 — 思维导图：生产级 slog 不是把文本换成 JSON，而是把日志字段、上下文、错误级别和观测链路统一起来。

先想清楚：日志是给机器查的，不只是给人看的

普通文本日志适合本地调试，但生产环境里你更常做的是搜索和聚合：某个用户最近 10 分钟发生了什么、某个接口 P99 升高时有没有下游错误、某类 error 一小时出现了多少次。

所以字段名要稳定。不要今天叫 uid，明天叫 userId，后天又叫 user_id。日志系统最怕字段随心情漂移，最后查询语句比业务代码还难维护。

我的基础字段习惯

入口层我通常会固定这些字段：service、env、request_id、trace_id、method、path、status、cost_ms。业务字段另算，比如 user_id、order_id、tenant_id。

字段不是越多越好。高基数字段比如完整 URL、原始请求体、超长 SQL，不应该随便打进每条日志。否则检索成本、存储成本、隐私风险都会上来。

Go slog 生产日志落地流程图 — 流程图：从入口统一注入上下文，到业务层补关键字段，再到边界层分类打日志，最后进入检索和告警。

入口层先做一件事：准备好带上下文的 logger

我不喜欢在每个函数里重新拼 request_id。更舒服的做法是在入口处构造一个带公共字段的 logger，然后往下传，或者从 context 里取。

func withLogger(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        rid := requestID(r)
        traceID := traceIDFromContext(r.Context())

        logger := slog.Default().With(
            "request_id", rid,
            "trace_id", traceID,
            "method", r.Method,
            "path", r.URL.Path,
        )

        ctx := context.WithValue(r.Context(), loggerKey{}, logger)
        next.ServeHTTP(w, r.WithContext(ctx))
    })
}

这里要克制一点：context 里可以放 request-scoped logger，但不要把一堆业务参数都塞进去。业务参数还是通过函数参数传，日志字段只保留排障需要的上下文。

错误日志：不要每层都打，也不要只打一层 failed

Go 代码里最容易把日志打乱的地方就是 error。底层一失败就打一条，service 再打一条，handler 又打一条，最后同一个错误刷三遍，告警看起来像三次事故。

我的规则是：中间层负责返回带上下文的 error，边界层负责决定日志级别和字段。比如 handler、consumer、cron job 这些地方才是真正适合落日志的位置。

func (h *Handler) GetOrder(w http.ResponseWriter, r *http.Request) {
    ctx := r.Context()
    orderID := r.PathValue("id")

    order, err := h.svc.GetOrder(ctx, orderID)
    if err != nil {
        logger := Logger(ctx).With("order_id", orderID)
        if errors.Is(err, ErrOrderNotFound) {
            logger.WarnContext(ctx, "order not found", "err", err)
            http.Error(w, "not found", http.StatusNotFound)
            return
        }
        logger.ErrorContext(ctx, "get order failed", "err", err)
        http.Error(w, "internal error", http.StatusInternalServerError)
        return
    }

    _ = json.NewEncoder(w).Encode(order)
}