Golang与Gin框架开发动态菜单权限管理-Golang-PHP中文网

菜单树必须一次性查全量并用map组装，禁止递归查询；权限校验需在handler中按角色实时过滤树结构；rule表须区分menu/action类型且frontpath加唯一索引；高并发下用singleflight防击穿。

golang与gin框架开发动态菜单权限管理

菜单树结构必须一次性查全量，不能递归查子节点

菜单渲染卡顿、接口超时，90% 是因为用了「查一层、再查下一层」的递归 SQL 方式。比如查 ID=1 的菜单，再查 parent_id=1 的子项，再查 parent_id=2 的孙子项……N 层就发 N 次查询。

正确做法是：一次 SELECT id, parent_id, name, path, sort, icon 查出所有启用菜单（WHERE status = 1），然后用 map 做索引组装树：

menus := []Menu{}
db.Where("status = ?", 1).Select("id, parent_id, name, path, sort, icon").Find(&menus)

byID := make(map[uint]*Menu)
roots := []*Menu{}

for i := range menus {
    byID[menus[i].ID] = &menus[i]
}

for i := range menus {
    m := &menus[i]
    if m.ParentID == 0 {
        roots = append(roots, m)
    } else if parent, ok := byID[m.ParentID]; ok {
        // Children 必须是 []*Menu 类型，不是 []Menu
        parent.Children = append(parent.Children, m)
    }
}

ParentID 字段类型要和判断一致：如果是 NOT NULL DEFAULT 0，就用 == 0；如果是 NULL，就得用 == nil 或 sql.NullInt64
排序必须在 SQL 里做：ORDER BY parent_id, sort，否则遍历顺序乱，树形错位
Children 字段定义必须是指针切片：Children []*Menu `json:"children,omitempty"`，值类型追加无效

权限校验不能放在 Gin 中间件里过滤菜单

把菜单权限检查塞进 JWT 中间件，会导致两个问题：一是菜单没显示但 URL 能直连（中间件只管鉴权，不管展示）；二是菜单显示了却点不开（权限没校验到具体菜单项）。

菜单是「用户能看到哪些入口」，不是「能否访问某接口」。它必须在 handler 渲染前，按当前用户角色实时过滤：

先查出用户所有角色 → 查出这些角色绑定的所有 rule 记录（含 menu=1 的）→ 提取 id 集合
用该集合去 filter 已构建好的 roots 树，递归剔除无权限节点（包括空父节点）
缓存建议按 role_ids 拼接 key（如 menu_tree:1_3），而非用户 ID，避免一人多角色频繁失效

别用中间件做这一步——它不持有菜单树上下文，也无权决定哪些节点该隐藏。

rule 表设计要区分 menu 和 action，且 path 必须唯一约束

很多团队把菜单和按钮权限混在一张表里，靠 menu 字段（tinyint）区分，结果导致前端路由 path 重复、权限映射错乱。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

关键约束和字段含义必须明确：

menu TINYINT DEFAULT 1：1=菜单项（需出现在左侧导航），0=操作权限（如「编辑」「删除」按钮）
frontpath VARCHAR(50)：菜单的前端路由路径，**必须加唯一索引**（UNIQUE KEY uk_frontpath (frontpath)），防止重复注册
cond VARCHAR(50)：仅对 menu=0 有效，表示操作码（如 user:update），供按钮级权限校验
method VARCHAR(10)：非必须，但建议填（如 POST），和后端接口权限校验联动

如果 frontpath 不唯一，前端 router.addRoute() 会覆盖；如果没区分 menu 类型，后端无法判断该渲染成菜单还是按钮。

菜单加载要防并发重复查询，用 singleflight.Group 包裹

高并发下多个请求同时触发菜单加载，可能瞬间打垮数据库——尤其当菜单表没加好索引或关联太多时。

Gin handler 内不要裸调 db.Find()，应封装一层防击穿：

var menuLoadGroup singleflight.Group

func LoadMenuTree(ctx context.Context, roleIDs []uint) ([]*Menu, error) {
    key := fmt.Sprintf("menu_tree:%v", roleIDs)
    v, err, _ := menuLoadGroup.Do(key, func() (interface{}, error) {
        // 实际查库 + 构建树逻辑
        return buildMenuTree(ctx, roleIDs)
    })
    if err != nil {
        return nil, err
    }
    return v.([]*Menu), nil
}