多级权限校验必须在中间件中分层实现RBAC+资源动作动态比对,而非硬编码role字段;Refresh Token需单次有效、存Redis并绑定设备指纹,自动续签本质是用其换新Access Token而非延长旧Token。

直接说结论:多级权限校验必须在中间件里做分层判断,不能只靠 role 字段硬编码;Token 自动续签不是“延长旧 Token”,而是用 Refresh Token 换新 Access Token,且 Refresh Token 必须单次有效、存 Redis 并设短过期。
中间件里怎么实现多级权限校验(RBAC + 资源动作)
权限不是“admin 就能干所有事”,而是“某个用户对某类资源能否执行某个动作”。Gin 或 net/http 中间件里不能只检查 claims.Role == "admin",得结合请求路径和 HTTP 方法动态比对。
- 从
c.Request.URL.Path和c.Request.Method提取资源标识(如/api/v1/orders)和动作(DELETE→ 对应order:delete) - 查数据库或内存缓存获取该用户当前拥有的权限列表(如
[]string{"user:read", "order:read", "order:create"}),注意每次请求都查——防止用户权限变更后 Token 还没过期 - 用
strings.HasPrefix或白名单 map 做前缀匹配:order:delete匹配order:*,但不匹配user:* - 拒绝时返回
403 Forbidden,别返回401(那是认证失败,不是授权失败)
Refresh Token 怎么设计才不会被重放
自动续签的核心风险是 Refresh Token 被截获后反复使用。它必须满足三个条件:存储在服务端、单次有效、绑定设备指纹(可选)。
- Refresh Token 本身不塞进 JWT,而是存在 Redis,key 是
"refresh:" + userID + ":" + userAgentHash,value 存加密后的随机字符串 + 过期时间(建议 7 天) - Access Token 过期时,客户端带
refresh_token字段发起请求,服务端先用它查 Redis,命中则删掉旧值、生成新 Access Token,并写入新 Refresh Token(同样单次有效) - 如果 Redis 查不到或已删除,直接返回
401,强制重新登录 - 别把 Refresh Token 放 Cookie 且没设
HttpOnly和Secure—— XSS 可窃取
jwt.ParseWithClaims 容易漏掉的三处校验
很多项目解析 Token 后就直接取 claims.UserID,结果线上出问题才发现过期、签名错、字段空都没拦住。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 必须显式判断
token.Valid == true,err == nil只代表语法合法,token.Valid才代表签名正确且未过期 - 类型断言后要判空:
if claims, ok := token.Claims.(*Claims); !ok || claims == nil,否则claims.UserIDpanic - 标准字段必须用
jwt.NewNumericDate()包装:ExpiresAt: jwt.NewNumericDate(time.Now().Add(15 * time.Minute)),传time.Time或 int64 都会导致exp校验失效
为什么不能用 jwt.MapClaims 做多级权限
因为 jwt.MapClaims 是 map[string]interface{},你存 "permissions": []string{"order:read"},解析后取值要写 perms, ok := claims["permissions"].([]interface{}),再逐个转 string——既容易 panic,又没法做结构体字段校验和 IDE 提示。
- 定义结构体嵌入
jwt.RegisteredClaims,额外加Permissions []string json:"permissions" - 生成时用
jwt.NewWithClaims(jwt.SigningMethodHS256, &MyClaims{...}) - 解析时用
jwt.ParseWithClaims(tokenStr, &MyClaims{}, keyFunc),字段类型安全、IDE 可跳转、字段名拼错编译期就报错
最常被忽略的一点:权限校验和 Refresh Token 都依赖实时数据源。Redis 里 Refresh Token 没了,或 DB 里用户权限更新了,中间件必须立刻感知——缓存不能设长过期,更不能本地内存 cache 权限列表。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










