如何在Echo框架中通过中间件传递用户上下文-Golang-PHP中文网

正确做法是将用户信息注入c.request().context()而非c.set()，因只有context.context能穿透日志器、http客户端和goroutine；需用context.withvalue()注入并调用c.setrequest()更新请求引用。

如何在echo框架中通过中间件传递用户上下文

中间件里用 `c.Set()` 存用户信息根本传不到日志和下游 HTTP 请求

直接调用 c.Set("user_id", 123) 看似简单，但这个值只在当前 echo.Context 实例里有效。一旦你用 zerolog 或 zap 打日志，或者调用 http.Client.Do(req) 转发请求，这些操作压根看不到 c.Set() 的内容——因为它们不读 echo.Context，只认 context.Context。

真正能穿透日志器、HTTP 客户端、goroutine 的唯一载体是 req.Context()。必须把用户信息塞进这里，而不是 c.Set()。

日志器（如 zerolog.Ctx(c.Request().Context())）只从 context.Context 取字段
http.NewRequestWithContext() 必须传带用户信息的 context，否则下游服务收不到 X-User-ID
启动 goroutine 时若没显式传 c.Request().Context()，子协程就彻底丢失上下文

正确做法：用 `context.WithValue()` 注入 `c.Request().Context()`

在鉴权中间件中解析完 token 后，别存 c.Set()，而是重建 request 并注入 context：

func AuthMiddleware(next echo.HandlerFunc) echo.HandlerFunc {
    return func(c echo.Context) error {
        token := c.Request().Header.Get("Authorization")
        userID, err := parseToken(token) // 你的解析逻辑
        if err != nil {
            return c.JSON(http.StatusUnauthorized, echo.Map{"error": "invalid token"})
        }

        // ✅ 正确：注入到 req.Context()
        ctx := context.WithValue(c.Request().Context(), "user_id", userID)
        req := c.Request().WithContext(ctx)
        c.SetRequest(req) // ⚠️ 这一步不能少，否则后续 c.Request() 拿不到新 context

        return next(c)
    }
}

键名建议用自定义类型（如 type ctxKey string），避免字符串冲突
c.SetRequest() 是强制步骤，Echo 不会自动更新内部 request 引用
不要用 context.WithValue() 存大对象（如 struct 指针），只放轻量标识（int64、string）

下游组件如何读取这个用户 ID

所有依赖上下文的地方，都得主动从 c.Request().Context() 里取，而不是从 c 上拿：

Echo框架 5.1.0

Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。

下载

日志：zerolog.Ctx(c.Request().Context()).Info().Int64("user_id", userID).Msg("request handled")
HTTP 转发：req, _ := http.NewRequestWithContext(c.Request().Context(), "GET", url, nil)
异步任务：go func(ctx context.Context) { ... }(c.Request().Context())
业务 handler 中读取：userID := c.Request().Context().Value("user_id").(int64)（注意类型断言）

如果用了 OpenTelemetry，更推荐把用户 ID 写进 span 属性，而非 raw context value，避免污染传播链。