路由级权限拦截必须在中间件阶段完成,而非handler中;需建立“方法+标准化路径”到权限码的全局映射,JWT权限字段要正确解析为[]string,菜单权限与接口权限须分离设计。

路由级权限拦截不是靠“给某个 GET 或 POST 加个装饰器”就能生效的,它必须在请求匹配到具体路由前,通过中间件完成权限校验;否则,路由已进 handler,再拒绝对应逻辑就晚了。
为什么不能在 handler 里做权限判断
权限拦截的目标是「拒绝访问」,不是「返回错误数据」。如果把 if !hasPerm() { return c.JSON(403, ...) } 写在 handler 里,意味着:
- 路由已成功匹配,中间件链(如日志、CORS)已执行一遍
- DB 或缓存查询可能已触发(哪怕只查一次,也是冗余)
- 前端看到的是业务层返回的 403,而非标准 HTTP 拒绝语义,某些网关或监控工具会误判为业务异常
真正有效的拦截,必须发生在 echo.HandlerFunc 执行之前,也就是中间件阶段。
怎么用中间件绑定路由路径与权限标识
核心是建立「HTTP 方法 + 标准化路径」→「权限码」的映射,而不是让每个路由自己声明权限字段。常见错误是把权限写死在路由注册时,比如 e.GET("/users", Auth("user:list"), handler) —— 这会导致权限配置分散、无法统一管理、难以审计。
推荐做法:
- 维护一张全局映射表:
map[string]string{"GET /api/users": "user:list", "DELETE /api/users/:id": "user:delete"} - 中间件里拼出 key:
c.Request().Method + " " + normalizePath(c.Request().URL.Path),其中normalizePath要处理尾部/、参数占位符(如将/users/123映射为/users/:id) - 查表得权限码后,再比对用户实际拥有的权限列表(来自 JWT claims 或 session),不匹配则直接
c.NoContent(403)
注意:c.Param("id") 在中间件里不可用,因为路由参数解析发生在匹配之后;要用 echo.New().Router().Find() 或提前注册的路径模板做标准化。
JWT 中取权限字段容易踩的坑
很多人把权限存在 claims["perms"],但解码后直接断言成 []string 会 panic,因为 JSON 解析默认是 []interface{}。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
正确方式:
- 先用
jwt.MapClaims解码,再取claims["menu_perms"] - 类型断言为
[]interface{},再逐个转成string构建[]string - 别在中间件里每次调
parseJWT(),应复用已解析好的 claims(比如由前置鉴权中间件塞进c.Set("claims", claims))
示例片段:
claims := c.Get("claims").(jwt.MapClaims)
if perms, ok := claims["menu_perms"]; ok {
if permSlice, ok := perms.([]interface{}); ok {
allowed := make([]string, 0, len(permSlice))
for _, p := range permSlice {
if s, ok := p.(string); ok {
allowed = append(allowed, s)
}
}
// 后续用 allowed 做 contains 判断
}
}
动态菜单权限和接口权限必须分开设计
这是最容易混淆的一点:「能看见菜单」≠「能调这个接口」。前端菜单展示依赖 user:list,但后台接口 GET /api/users 可能需要更细粒度的 user:list:own 或角色组合判断。
所以:
- 菜单权限映射表(
route → menu_perm)只用于控制前端入口可见性,不应参与接口访问控制 - 接口级权限校验应走另一套策略,比如 Casbin 的
enforcer.Enforce(sub, obj, act),其中obj是/api/users,act是GET - 两个权限系统可以共用同一份用户数据源,但校验逻辑、失败响应、缓存策略必须隔离
如果你发现某个接口被拦截了但菜单还显示着,大概率是把这两层混在一起用了。










