Kratos中间件必须通过ServerOption注册,如http.Middleware(...),而非原生http.Handle链路;自定义中间件需返回middleware.Middleware类型,且顺序为逆序执行,JWT与Casbin须串行且提前初始化。

中间件注册必须在 ServerOption 里配,不是加到 handler 上
Kratos 的中间件不走 Go 原生 http.Handle 那套链路,不能像写普通 HTTP 服务那样用 middleware(next http.Handler) 包一层再注册路由。它只认 http.ServerOption 或 grpc.ServerOption 里的 http.Middleware(...) 或 grpc.Middleware(...)。
常见错误是把中间件函数直接传给 http.NewServer,漏掉 http.Middleware() 这层包装,结果中间件完全不执行。
- 正确写法:
http.Middleware(recovery.Recovery(), logging.Server(logger), myAuth()) - 错误写法:
http.NewServer(http.Address(":8000"), myAuth())——myAuth()不会被调用 - 中间件顺序很重要:越靠后的中间件越先执行(责任链逆序),比如
recovery应该放最后兜底,logging放中间,鉴权放最前
自定义中间件必须返回 middleware.Middleware 类型
Kratos 的 middleware.Middleware 是个函数类型:func(handler middleware.Handler) middleware.Handler,不是 func(http.Handler) http.Handler。强行混用会导致编译失败或 panic。
你不能直接复用原生 HTTP 中间件,必须做适配。例如想用日志中间件,得从 transport.FromServerContext(ctx) 拿 path/method,而不是从 *http.Request 解析。
- 必须 import
"github.com/go-kratos/kratos/v2/middleware"和"github.com/go-kratos/kratos/v2/transport" - 前置逻辑里用
tr, ok := transport.FromServerContext(ctx)判断协议类型(HTTP/gRPC),再取tr.Operation()或tr.Path() - 不要试图在中间件里调
w.WriteHeader()或写 response body —— Kratos 的 HTTP transport 已封装好,你只管 ctx 和 error
JWT 鉴权中间件必须显式传 signing key,否则 panic
jwt.New() 不会默认读配置或环境变量,jwt.WithSigningKey() 是必填项。漏掉就直接 panic:signing key is required。而且 jwt.WithSigningMethod(jwt.SigningMethodHS256) 必须和签发 token 时用的算法严格一致,否则报 token is invalid。
- key 类型必须是
[]byte,别传字符串字面量(如"my-key")而不转[]byte("my-key") - token 默认从
Authorization: Bearer <token></token>提取;如果前端用X-Token头,得自己写 wrapper 调jwt.ParseToken(),不能依赖默认行为 - 解析后的
*jwt.Token存在ctx.Value里,业务 handler 里要手动调jwt.FromContext(ctx)取,不会自动注入 struct 字段
Casbin 权限控制必须接在 JWT 后面,且 enforcer 要提前初始化
JWT 中间件只负责“这个人是不是合法用户”,Casbin 才管“这个用户能不能访问这个接口”。两者不能合并成一个中间件,必须串行:JWT → Casbin → 业务 handler。
如果 Casbin 的 enforcer 在中间件里是 nil,说明初始化太晚——它必须在 HTTP server 启动前就准备好,推荐在 wire.go 里通过 provider 注入,而不是在中间件函数里 lazy 初始化。
-
sub一般用user.ID或user.Role,obj建议拼成r.URL.Path + ":" + r.Method格式(如/v1/users:POST) - gRPC 场景下
obj可用tr.Operation(),比如api.UserService/GetUser - 别在中间件里重复调
enforcer.LoadPolicy(),策略加载应只在启动时做一次


















