菜单权限必须由后端接口动态返回,Revel仅负责安全渲染;禁止前端硬编码或模板if判断;需后端组装树形结构、模板判空渲染;路由层须同步校验权限;角色变更后须主动刷新菜单。

菜单权限不能靠前端隐藏或 if 判断硬编码实现,必须由后端接口返回当前用户可访问的菜单结构,Revel 框架只负责接收并安全渲染——否则任何修改 HTML 或绕过路由都能越权访问。
菜单数据必须从后端接口获取,不能写死在模板里
Revel 本身不提供菜单权限中间件或内置菜单管理,所有菜单项必须由后端接口(如 /api/user/menu)动态返回。常见错误是把菜单结构直接写进模板或控制器里:
- ❌ 在
app/controllers/app.go中写死menus := []Menu{{Name: "用户管理", Path: "/users"}}—— 权限变更需发版,且无法按角色/部门差异化 - ❌ 在模板中用
{{if .Role == "admin"}}{{template "menu-admin.html"}}{{end}}—— 角色字段可能被篡改,JWT 中的 role 不可信 - ✅ 正确做法:登录后调用
c.RenderJSON(menus)返回扁平或树形结构,字段至少包含path、name、icon、permission
模板中用 range 渲染菜单,且必须判空防 panic
Revel 模板不支持自动解构嵌套数组,菜单若为树形结构(含 Children 字段),需在后端完成层级组装;若为扁平结构,则靠 ParentID 在模板中递归或分组。无论哪种,range 前必须加 {{if .menus}} 判空:
- ❌
{{range .menus}}@#@#@#@#@#@#@#@#@#@0{{end}}—— 若.menus是nil,模板执行直接 panic - ✅
{{if .menus}}{{range .menus}}@#@#@#@#@#@#@#@#@#@0{{end}}{{end}} - 若需索引(比如生成 menu-item-0 类名),必须用双变量语法:
{{range $i, $m := .menus}}
Render 传参要导出字段,且避免混用 Render 和 RenderArgs
菜单数据通常以切片或 map 形式传入,但 Revel 对结构体字段可见性敏感:
- ❌ 传入
type Menu struct { name string }(小写字段)→ 模板中{{.name}}渲染为空,无报错 - ✅ 改为
type Menu struct { Name string },模板用{{.Name}} - ❌ 同时调用
c.Render("menus", menus)和c.RenderArgs["menus"] = menus→ 后者覆盖前者,导致数据错乱 - ✅ 只用一种方式:推荐
c.Render("menus", menus),简洁且不易误操作
权限校验不能只在菜单层,路由守卫必须同步做
即使菜单没渲染“财务报表”项,用户仍可手动输入 /reports/finance 访问。Revel 没有类似 @PreAuthorize 的注解,必须手动拦截:
- 在 controller action 开头检查:
if !hasPermission(c.Params.Get("roles"), "menu:report:finance") { c.Abort(403); return } - 或统一收口到
AuthzFilter:用path.Match("/api/v1/reports/**", c.Request.URL.Path)匹配路径前缀,避免用strings.Contains导致/user/delete被/user规则误放行 - 注意:JWT 场景下必须先禁用默认
SessionFilter,否则c.Params可能被污染,权限判断失效
菜单权限最易被忽略的一点:权限码变更后,前端缓存的菜单数据不会自动刷新。用户切换角色时,必须主动触发重新请求 /api/user/menu 并更新本地状态,否则看到的仍是旧菜单。











