Golang日志中如何有效追踪请求

要想在 Golang 里把请求追踪得明明白白，其实核心就几步。下面这张图大概勾勒了整体思路，我们来展开聊聊。

几个关键步骤

首先，选一个趁手的日志库。logrus、zap 或者 stdlog 都是不错的选择，它们提供了日志级别、格式化输出这些基本功，省去不少自己造轮子的功夫。

其次，给每个请求一个独一无二的 ID。没有 ID 的日志就像没有标签的快递，谁是谁根本分不清。用 github.com/google/uuid 生成一个 UUID 绑到请求上，后续所有日志都能跟它挂钩。

然后，通过中间件机制把请求 ID 捞出来，传给后面的处理程序。中间件就像关卡安检员，在请求真正进入业务逻辑之前，先把证件（ID）挂好，这样后续每个环节都能在日志里带上这个 ID。

接下来是日志格式。结构化的日志才是好日志——包括请求 ID、时间戳、日志级别、处理程序名称，这些字段堆在一起，排查问题时一眼就能定位到相关记录。

最后，利用 context.Context 把请求 ID 和相关信息一路传递下去。Golang 的 context 就像一根贯穿请求全生命周期的线索，保证无论走到哪个 goroutine 或函数里，都能拿到这个 ID。

一个实际例子

下面这段代码展示用 logrus 搭配中间件怎么实现上述思路：

package main

import (
    "context"
    "fmt"
    "github.com/google/uuid"
    "github.com/sirupsen/logrus"
    "net/http"
)

type loggerKey struct{}

func main() {
    logrus.SetFormatter(&logrus.JSONFormatter{})
    http.HandleFunc("/", requestHandler)
    http.ListenAndServe(":8080", nil)
}

func requestHandler(w http.ResponseWriter, r *http.Request) {
    requestID := r.Header.Get("X-Request-ID")
    if requestID == "" {
        requestID = uuid.New().String()
        r.Header.Set("X-Request-ID", requestID)
    }
    ctx := context.WithValue(r.Context(), loggerKey{}, requestID)
    logrus.WithFields(logrus.Fields{
        "requestID": requestID,
    }).Info("Request received")
    // 处理请求...
}

func logMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        logrus.WithFields(logrus.Fields{
            "requestID": r.Header.Get("X-Request-ID"),
        }).Info("Processing request")
        next.ServeHTTP(w, r)
    })
}

在这个例子里，中间件负责在请求进入时记录日志并传递 ID；处理函数通过 context 拿到 ID，再把它塞到日志字段里。这样一来，所有日志条目都带有同一个请求 ID，无论是调试线上问题还是分析请求链路，都会清晰很多。