Revel中菜单权限控制必须在Controller/Service层预过滤,不可交由模板处理。需查全量菜单后按用户权限裁剪树结构,确保菜单显示与URL访问权限一致,避免403或越权直连。

Revel 模板中动态渲染菜单前必须过滤权限
菜单不是“查出来就直接渲染”,而是查全量后,在模板外(Controller 或 Service 层)按当前用户权限实时过滤。Revel 没有内置菜单权限函数,menu.Children 的生成和 userHasPerm 校验必须手动介入,否则会出现「菜单显示但点击 403」或「菜单不显示却能直连 URL」的割裂问题。
- 数据库一次查出所有菜单(含
id、parent_id、permission_code),不要递归查询 - 用
map[uint]*Menu建索引,再遍历组装树结构,Children字段必须是[]*Menu(指针切片) - 根节点过滤条件:仅当
ParentID == 0且PermissionCode == ""或userHasPerm(PermissionCode)为 true 时才加入rootMenus - 子节点只在父节点已确定可见的前提下才加入其
Children,避免空父节点挂载子项
在 Controller 中预处理菜单并传入模板
Revel 模板本身不持有用户上下文,权限判断不能丢给模板做。必须在 Action 方法里完成菜单树构建与权限裁剪,再通过 c.RenderArgs 传给模板。别指望 {{if .user.HasRole "admin"}} 这类写法——Revel 的 .user 不是自动注入的,也无内置角色方法。
- 调用类似
buildUserMenuTree(userID)的服务函数,返回[]*Menu(已裁剪完毕) - 赋值:
c.RenderArgs["menus"] = rootMenus,确保模板收到的是最终可渲染结构 - 若菜单需区分「路由可见性」和「按钮操作权限」,建议把
permission_code保留在每个Menu实例上,供前端 JS 后续控制按钮显隐
模板中安全遍历菜单树并嵌套渲染
Revel 使用 Go 标准 html/template,range 遍历菜单时容易掉进上下文丢失、nil panic 和变量覆盖坑里。尤其子菜单递归渲染时,. 会变成当前 Menu 实例,外层传入的 .menus 就不可见了。
- 主模板用双变量
{{range $i, $m := .menus}},显式绑定索引和元素,避免意外覆盖 - 子菜单递归调用必须显式传参:
{{template "menu-item.html" (dict "menu" $m "depth" 1)}}(前提是已注册dict函数) - 子模板内访问字段一律用
{{$menu.Name}}、{{$menu.Path}},禁止直接写.Name—— 因为.此时是dict构造的 map - 判断是否有子项:用
{{if $menu.Children}},而非{{if .Children}},防止 nil panic
为什么不能把权限逻辑塞进模板函数?
有人试图写个 {{menuIfPermitted "admin:dashboard"}} 模板函数,看似简洁,实则埋雷:每次调用都可能触发 DB 查询或 session 解析,模板渲染变成副作用密集区;更严重的是,它绕过了 Revel 的拦截器机制,导致权限校验点与路由 handler 脱节——URL 可被直连,菜单却没显示,安全边界失效。
真正该复用的是权限判定逻辑(如 userHasPerm),它应位于 service 层,被 Controller 和中间件共用;而模板只负责「把已经裁剪好的菜单,干净地画出来」。最容易被忽略的一点:菜单缓存必须按用户角色 ID 分片,不能全局共用一份树结构。











