gRPC UnaryInterceptor 必须调用 handler(ctx, req) 否则 panic;鉴权失败应返回 nil, status.Error;元数据需用 metadata.FromIncomingContext 提取;建议用 grpc_middleware.ChainUnaryServer 拆分职责;注册拦截器需在 grpc.NewServer() 中传入。

gRPC UnaryInterceptor 怎么写才不 panic
直接 panic 的常见原因是 handler 没被调用,或者返回了 nil。gRPC 要求拦截器必须把请求最终交给 handler,否则连接会直接断开,客户端收到 rpc error: code = Internal desc = transport is closing。
- 必须在拦截器末尾显式调用
handler(ctx, req),不能只做逻辑判断就 return - 如果想拒绝请求(比如鉴权失败),要用
return nil, status.Error(...),而不是return或return nil, nil -
ctx如果被 cancel 或 deadline 超时,handler仍要调用——它会快速失败,但这是预期行为 - 别在拦截器里 recover panic,gRPC 的
UnaryServerInterceptor签名不支持返回 error 以外的异常处理
怎么在拦截器里取 HTTP Header 或 gRPC Metadata
gRPC 的元数据(比如 Authorization)不是放在 HTTP header 原始 map 里,而是通过 metadata.MD 封装,且必须用 grpc.Peer 或 metadata.FromIncomingContext 提取。
- 正确方式是:
md, ok := metadata.FromIncomingContext(ctx),ok为 false 表示没带元数据 - 取 token 示例:
vals := md["authorization"],注意 key 是小写(gRPC 自动规范化),vals是字符串切片,通常取vals[0] - 不要试图从
http.Request.Header取——服务端根本拿不到原始 http.Request,那是底层 transport 层的事 - 如果前端用 curl 或 grpcurl 发送,header 必须加
-H "Authorization: Bearer xxx",gRPC 客户端则要用metadata.Pairs("authorization", "Bearer xxx")
日志和认证逻辑怎么分层才不耦合
一个拦截器塞认证 + 日志 + 耗时统计,看着省事,实际维护起来容易互相干扰:比如日志 panic 会导致认证失效,或认证提前 return 后日志没打全。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 推荐拆成两个独立拦截器,按顺序注册:
grpc.UnaryInterceptor(chain(authInterceptor, loggingInterceptor)) - 用
grpc_middleware.ChainUnaryServer(来自github.com/grpc-ecosystem/go-grpc-middleware)来组合,别手写嵌套调用 - 每个拦截器只做一件事:auth 拦截器只校验 token 并 set user ID 到 ctx;log 拦截器只打开始/结束日志、记录耗时、提取
ctx.Value("user_id") - 跨拦截器传值统一用
context.WithValue,key 用自定义类型避免冲突,比如type userIDKey struct{}
为什么本地测试正常,上线后拦截器不生效
最常见原因是服务启动时没把拦截器注册到 grpc.Server 实例上,或者注册了但用了错误的 server 选项。
立即学习“go语言免费学习笔记(深入)”;
- 确认初始化 server 时写了:
grpc.NewServer(grpc.UnaryInterceptor(yourInterceptor)),不是grpc.NewServer().UnaryInterceptor(...)(后者无效) - 如果你用的是
grpc.Creds或grpc.KeepaliveParams等其他选项,确保它们和UnaryInterceptor在同一层NewServer调用中传入 - 检查是否误用了
grpc.Dial的拦截器(client-side),而你实际要改的是 server 端 - Kubernetes 或 service mesh(如 Istio)可能劫持了流量,绕过你的 gRPC server——先用
telnet your-svc 9000确认连的是你部署的 pod
真正麻烦的不是写拦截器,而是当多个拦截器共享 ctx、同时修改 deadline 或 cancel 时,谁先谁后、谁覆盖谁——这些细节不会报错,但会让超时行为变得不可预测。

















