不能直接修改原context.Context,只能派生新context.Context并显式传给后续链路;需用context.WithValue()创建新ctx,且key必须为私有类型,Unary拦截器中传给handler(),Stream拦截器中需包装ServerStream重写Context()方法。

gRPC拦截器里Context能被修改吗
不能直接“修改”原context.Context,但可以派生新context.Context并传给后续链路——这是唯一合规方式。gRPC的UnaryServerInterceptor和StreamServerInterceptor签名都要求你显式返回一个带新ctx的响应或流对象,否则下游handler拿到的仍是原始ctx。
常见错误是只调用context.WithValue()却没把结果传下去,比如忘了在handler(ctx, req)里传新ctx,或者流拦截器里没对srv或ss做上下文替换。
- 必须用
ctx = context.WithValue(oldCtx, key, value)生成新ctx - 必须把新
ctx显式传给handler(ctx, req)(unary)或封装serverStream(stream) - key不能是
string,得是私有类型(避免冲突),例如type ctxKey string; const userIDKey ctxKey = "user_id"
Unary拦截器中传递用户ID等自定义值
典型场景:鉴权拦截器从token解析出userID,想让业务Handler能直接取到。关键不是“存”,而是“确保下游能取到”。
func authInterceptor(ctx context.Context, req interface{}, info *grpc.UnaryServerInfo, handler grpc.UnaryHandler) (interface{}, error) {
// 解析token...
userID := parseUserIDFromToken(ctx)
// 派生新ctx
ctx = context.WithValue(ctx, userIDKey, userID)
// ⚠️ 必须把ctx传给handler!
return handler(ctx, req)
}
业务Handler里这样取:
func (s *service) DoSomething(ctx context.Context, req *pb.Req) (*pb.Resp, error) {
userID := ctx.Value(userIDKey).(string) // 类型断言需谨慎
// ...
}
注意:ctx.Value()返回interface{},强转前建议加if v, ok := ctx.Value(userIDKey).(string); ok { ... }判断,避免panic。
Stream拦截器怎么透传Context
流式拦截更麻烦,因为serverStream本身不暴露Context()方法,且gRPC内部会缓存原始ctx。正确做法是包装grpc.ServerStream,重写Context()方法返回新ctx。
- 不能直接改
ss.Context()返回值(不可写) - 必须实现自定义
wrappedStream结构体,嵌入原ss并覆盖Context() - 所有下游对
ss.Context()的调用都会走到你的新实现
type wrappedStream struct {
grpc.ServerStream
ctx context.Context
}
func (w *wrappedStream) Context() context.Context {
return w.ctx
}
// 在拦截器中:
func streamInterceptor(srv interface{}, ss grpc.ServerStream, info *grpc.StreamServerInfo, handler grpc.StreamHandler) error {
newCtx := context.WithValue(ss.Context(), traceIDKey, generateTraceID())
wrapped := &wrappedStream{
ServerStream: ss,
ctx: newCtx,
}
return handler(srv, wrapped)
}
为什么Context传不到下游Handler里
最常踩的坑就三个:
- 用了
context.WithValue()但没把返回的新ctx传给handler()或包装ServerStream - key用了
string字面量(如"user_id"),导致不同包之间key冲突,ctx.Value()取不到 - 在流拦截器里误以为
ss.Context()可修改,直接赋值(Go里Context()是方法,不是字段)
另外,gRPC的metadata.MD虽然也能传数据,但它走的是HTTP/2 header,和context.Context语义不同:前者跨网络,后者仅限本机goroutine链路。别混用。











