grpc-gateway问题：传递给HTTP Handler的Context丢失已设值

核心问题分析 #

你遇到的情况是上下文值在路径前缀处理器中可用，但经过gwmux.ServeHTTP传递后在myHttp函数中丢失，大概率是以下几个常见原因导致的：

排查与解决步骤 #

1. 确保myHttp使用请求自身的上下文 #

在myHttp函数中，必须从传入的*http.Request对象获取上下文，而不是复用外层处理器的上下文变量：

func myHttp(w http.ResponseWriter, r *http.Request) {
    // 正确方式：使用当前请求的上下文
    val := r.Context().Value("mykey")
    // 错误方式：直接用外层处理器的ctx变量
    // val := ctx.Value("mykey")
}

外层的ctx和请求携带的上下文是不同的实例，即使你通过r.WithContext(ctx)绑定，myHttp也只能从r.Context()拿到正确的上下文。

2. 基于请求上下文衍生新上下文 #

在路径前缀处理器中，必须基于当前请求的上下文（r.Context()）来衍生带值的新上下文，而不是使用独立的上下文：

http.Handle("/api/", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    // 正确：从请求上下文衍生，保证上下文链连续
    ctx := context.WithValue(r.Context(), "mykey", "expected-value")
    // 传递带新上下文的请求给gwmux
    gwmux.ServeHTTP(w, r.WithContext(ctx))
}))

如果直接创建全新的上下文（比如context.Background()），会断开与请求上下文的关联，导致后续处理器无法拿到值。

3. 检查上下文键的类型一致性 #

上下文的值是通过键的类型+值来匹配的，很多时候取不到值是因为存值和取值的键类型不一致。建议使用自定义类型作为键，避免与其他库的键冲突：

// 定义自定义键类型
type ctxKey string
const myKey ctxKey = "mykey"

// 存值
ctx := context.WithValue(r.Context(), myKey, "expected-value")

// 取值
val := r.Context().Value(myKey)

如果存值用的是字符串"mykey"，但取值时不小心用了其他类型（比如int或自定义结构体），就会返回nil。

4. 排查gRPC-Gateway中间件的上下文修改 #

如果你的gwmux添加了自定义中间件，检查这些中间件是否会重置上下文。比如有些中间件会直接创建新的上下文而不继承原有值，这种情况下需要修改中间件逻辑，确保传递原有上下文的所有值：

// 错误的中间件：重置上下文
func badMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        // 这里创建了新的空上下文，丢失了原有值
        ctx := context.Background()
        next.ServeHTTP(w, r.WithContext(ctx))
    })
}

// 正确的中间件：继承原有上下文
func goodMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        // 基于请求上下文衍生，保留原有值
        ctx := context.WithValue(r.Context(), "another-key", "value")
        next.ServeHTTP(w, r.WithContext(ctx))
    })
}

内容的提问来源于stack exchange，提问作者Kyle