鉴权中间件必须在认证中间件之后注册,否则权限校验因 user_id 未写入 ctx 而 panic;应严格按 api.Use(authMw)→api.Use(permMw) 顺序挂载,使用自定义 key 类型存储用户信息,并通过 c.Route().Path 获取标准化路由路径匹配预热权限表。

鉴权中间件必须在认证中间件之后注册
顺序错,整个鉴权链就失效。Fiber 不像 Gin 那样自动管理 context 传递,c.Next() 执行后,后续中间件能否读到 user_id 完全取决于前一个中间件是否已写入。认证中间件(如 JWT 解析)负责把 user_id、role 写进 c.Context(),权限中间件只读不写。如果注册成 api.Use(permMw, authMw),permMw 一读就是 nil,ctx.Value(userKey("user_id")) panic。
正确做法是:
-
api.Use(authMw)→api.Use(permMw),严格按依赖顺序挂载 - 用自定义 key 类型,别用字符串:
type userKey string; const userIDKey userKey = "user_id" - 认证中间件校验失败时必须
c.Status(401).SendString(...)并return,不能漏掉return导致继续执行权限中间件
路径匹配别用 r.URL.Path 做字符串判断
r.URL.Path 是原始请求路径,没标准化,/users/123/、/users/123?foo=bar、/users/123#anchor 全部绕过 strings.Contains(r.URL.Path, "/admin")。Fiber 没有 c.FullPath()(那是 Gin 的),得靠 c.Route().Path 获取注册时的路由模板,比如 /users/:id,再手动正则替换 /:([^/]+) → /{\1},得到标准键 /users/{id}。
权限映射表预热加载时,就存 "GET:/users/{id}" → []string{"user:read"} 这类键值对,运行时只查 map,不查 DB。
立即学习“go语言免费学习笔记(深入)”;
显式放行公共路径:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
if c.Route() == nil || c.Route().Path == "/health" { c.Next(); return }if c.Method() == "OPTIONS" { c.Next(); return }
ctx.Params() 和 ctx.QueryParam() 别混用
鉴权中间件里想读 tenant,却写 c.Params("tenant") 总是空?那是因为 tenant 是 query 参数(如 ?tenant=prod),不是路由占位符。Fiber 路由匹配完成后才填充 c.Params,但全局中间件(app.Use())在路由匹配前就执行了,此时 c.Route() 还为 nil,c.Params() 必然为空。
正确姿势:
- 若
tenant来自 query:c.QueryParam("tenant") - 若来自 header:
c.Get("X-Tenant") - 若必须来自路由(如
/t/{tenant}/users),就把中间件局部注册:group := app.Group("/t/:tenant"); group.Use(tenantMw); group.Get("/users", handler)
JWT 校验必须显式检查 exp、iat、iss
只验签名不校验标准声明,等于裸奔。用 github.com/golang-jwt/jwt/v5,别用已废弃的 jwt-go(有 CVE-2023-37582)。claims 结构体必须嵌入 jwt.RegisteredClaims,然后调 claims.Validate() 一键校验。
关键细节:
-
keyFunc回调里加算法白名单:if token.Header["alg"] != "HS256" { return nil, errors.New("invalid alg") } - 密钥必须是 ≥32 字节的
[]byte,从环境变量读,别硬编码"secret" - 服务间调用 JWT 必须用
RS256,公钥启动时加载,私钥只存于授权中心 - 校验失败一律
c.Status(401).SendString("invalid token"),不 panic,不 log.Fatal
真正容易被忽略的是:权限中间件拿到 user_id 后,查角色权限时若走 DB,QPS 上千就会拖垮服务;预热加载必须做,且要支持后台定时刷新,不能只靠首次加载。还有,c.Next() 不是“继续执行”,而是“交还控制权”——只要前面中间件写了响应,后续所有 handler 和中间件都不会触发,这点和 Express 的 next() 逻辑完全不同。


















