jwt.Server仅完成认证(验签、过期等),不等于鉴权;必须配合Casbin等权限引擎及自定义中间件提取claims并校验RBAC策略,否则接口全放行或全401。

jwt.Server中间件只做解析和基础校验,不等于鉴权完成;必须配合自定义逻辑(如 Casbin)才能控制“谁有权限访问什么”。
为什么加了 jwt.Server 还是没鉴权效果?
常见现象是接口全放行或全 401,根本原因不是中间件没起作用,而是误把「认证」当「鉴权」。
-
jwt.Server只负责:从Authorization: Bearer xxx提取 token、验签名、检查过期、比对Issuer/Audience - 它不会自动读
sub字段、不会查用户角色、更不会调用权限引擎判断能否访问/v1/orders:POST - 若没后续中间件提取 claims 并做规则判断,HTTP handler 就直接执行了——等于只做了“你是本人”,没管“你能干啥”
jwt.Server 配错就 panic 或 401,关键参数不能漏
启动时崩溃或所有请求返回 token is invalid,基本锁定在初始化阶段。
- 必须传
jwt.WithSigningKey(),否则 panic 报错signing key is required - 签名算法必须和签发端严格一致:
jwt.WithSigningMethod(jwt.SigningMethodHS256)配成RS256就直接失败 - 密钥建议从配置加载,避免硬编码:
[]byte(os.Getenv("JWT_SECRET")),且 HS256 要求密钥长度 ≥32 字节 - 若前端用
X-Token头而非标准Authorization,得自己写 wrapper 包一层jwt.ParseToken
怎么把 JWT 用户信息传给 Casbin 做 RBAC 校验?
这是真正落地权限控制的衔接点,也是最容易断链的位置。
- 在
jwt.Server之后注册自定义中间件(比如叫casbinMiddleware),顺序错了就拿不到*jwt.Token - 用
jwt.FromContext(r.Context())拿到 token,再转成token.Claims.(jwt.MapClaims)提取"sub"或"role" -
enforcer.Enforce()的sub推荐传用户 ID(如"1001"),不是角色名;obj建议拼成r.URL.Path + ":" + r.Method(如"/v1/users:DELETE") - Casbin enforcer 必须在 HTTP server 启动前初始化完成,wire.go 里用 provider 注入最稳,否则中间件里拿到的是
nil
策略没生效?先查这三个地方
加了 jwt 和 casbin 中间件却没拦截,问题往往不在代码语法,而在运行时状态。
- 中间件注册顺序:casbin 必须在 jwt 之后,否则
jwt.FromContext()返回nil - Casbin 策略是否真实加载:别用
enforcer.AddPolicy()硬编码,生产必须用gorm-adapter或redis-adapter,否则重启服务策略就丢 - RBAC 模型中
sub类型要对齐:如果策略是p, admin, /v1/users:GET, allow,但代码里传的是用户 ID"1001",那永远不匹配——此时该用g, 1001, admin规则桥接
真正卡住人的从来不是 JWT 怎么 parse,而是 claims 怎么取、取出来怎么喂给权限引擎、权限引擎的策略怎么设计才不跟业务脱节。这些衔接点不手动串起来,框架只是在空转。











