http中间件须用闭包在返回函数内读取r；grpc一元拦截器需严格匹配四参数签名并调用handler；流式拦截器须包装serverstream；中间件链按嵌套顺序执行，panic需显式recover。
Go 微服务里写中间件，不是套个函数包装器就完事——关键得清楚在哪层拦截、参数怎么拿、错误怎么透传、链式顺序怎么控。直接上结论：HTTP 场景用 http.HandlerFunc 闭包封装最稳；gRPC 场景必须区分 UnaryServerInterceptor 和 StreamServerInterceptor，且不能混用；所有中间件都得在请求真正到达时才可读取/修改 req 或 rw，声明时捕获是无效的。
HTTP 中间件必须用闭包捕获真实请求对象
很多人写 func logging(next http.HandlerFunc) http.HandlerFunc 时，误以为能在返回函数体外访问 r *http.Request ——其实不行。参数只在调用时存在，闭包必须把逻辑写进返回的匿名函数内部。
- ✅ 正确写法：在
return func(w http.ResponseWriter, r *http.Request)内部读r.URL.Path、写日志、调next(w, r) - ❌ 错误写法：试图在
logging函数参数列表里解构r，或提前调r.ParseForm()——此时r还没被 net/http 实例化 - ⚠️ 注意：若需修改响应（如加 CORS 头），必须在
next调用前设置，否则WriteHeader已发，再写头会 panic
gRPC Unary 拦截器要严格匹配签名
grpc.UnaryServerInterceptor 是函数类型别名：func(ctx context.Context, req interface{}, info *grpc.UnaryServerInfo, handler grpc.UnaryHandler) (resp interface{}, err error)。少一个参数、类型错位、漏 return 都会导致编译失败或运行时 panic。
- ✅ 必须原样接收
ctx、req、info、handler四个参数，且handler必须被调用一次（否则业务逻辑不执行） - ✅
info.FullMethod是完整服务路径（如/helloworld.Greeter/SayHello），可用于按方法粒度限流或鉴权 - ⚠️
req是 interface{}，需断言为具体类型（如req.(*pb.HelloRequest)）才能取字段；断言失败会 panic，建议加if req, ok := req.(*pb.HelloRequest); ok
Stream 拦截器不能直接读消息内容
流式 RPC 的数据通过 Recv()/Send() 在 grpc.ServerStream 上流动，原始拦截器签名不暴露消息体。想记录或校验流数据，必须包装 ServerStream。
- ✅ 正确做法：实现
grpc.ServerStream接口的 wrapper 结构体，在RecvMsg和SendMsg方法里插入逻辑 - ✅ 注册时用
grpc.StreamInterceptor，但 handler 内部要 new wrapper 并传给下游 - ⚠️ 常见坑：直接在拦截器里调
ss.RecvMsg()——会提前消费消息，导致下游 handler 收不到 - ⚠️ 性能注意：流式包装器涉及内存拷贝和 goroutine 协调，高频小包场景要压测吞吐
中间件链顺序直接影响行为逻辑
多个中间件组合时，执行顺序不是“谁先注册谁先跑”，而是取决于你如何嵌套调用——最外层的最先执行，最内层的最后执行（类似洋葱模型）。
- ✅ 推荐用
go-grpc-middleware的chain.UnaryServerInterceptor组合，它按 slice 顺序依次 wrap，语义清晰 - ✅ HTTP 场景可用简单循环：
for i := len(interceptors)-1; i >= 0; i-- { h = interceptors[i](h) }，确保第一个中间件包裹最深 - ⚠️ 鉴权中间件必须在日志之前？不一定——如果鉴权失败要短路返回，那它就得在链首；如果要记录所有请求（含拒绝），就得放链尾
- ⚠️ gRPC 流式拦截器和一元拦截器无法共用同一链，必须分开注册，否则
grpc.NewServer会 panic
最易被忽略的点：中间件里的 panic 不会自动转成 gRPC 状态码或 HTTP 500，除非你显式 recover 并写响应。尤其在日志、限流、JWT 解析这些地方，没加 defer-recover 的拦截器一崩，整个连接就断了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
