Java菜单系统配置化设计实战教程

亲爱的编程学习爱好者，如果你点开了这篇文章，说明你对《Java配置化菜单系统设计实战详解》很感兴趣。本篇文章就来给大家详细解析一下，主要介绍一下，希望所有认真读完的童鞋们，都有实质性的提高。

菜单应配置驱动、动态渲染，后端仅提供按角色查询的标准接口，返回含id、parentId、path等字段的树形数据；权限校验需前后端双重控制，路由须动态注册，确保配置、权限、路由三者语义严格对齐。

菜单数据必须与业务逻辑解耦，用配置驱动渲染

菜单不是硬编码在 Controller 或前端模板里的静态结构，而是由配置中心（如 Nacos、Apollo）或本地 application.yml / JSON 文件定义的树形数据。核心在于：后端只提供 MenuService.getMenusByRole(String role) 这类接口，返回标准 List，字段包含 id、parentId、path、component、permission 等——这些字段直接映射到前端路由/权限系统，不掺杂 Java 业务判断。

常见错误是把菜单生成逻辑写进 @Controller 方法里，比如用 if-else 拼 HTML 或手动 new Menu 对象。这会导致每次加菜单都要改代码、发版、重启服务。

• 菜单配置建议用 YAML 分层表达父子关系，避免手写 JSON 容易出错
• path 字段必须符合前端 Vue Router / React Router 的路径规则（如 /user/list），不能带后缀或参数占位符
• component 值应为前端组件路径字符串（如 "views/user/UserList.vue"），后端不做解析，只透传
• 权限字段 permission 推荐用字符串数组（如 ["user:read", "user:export"]），方便前端 v-permission 指令消费

菜单实体需支持运行时动态组装，避免递归查询 N+1

数据库表设计通常为单表 sys_menu，含 id、parent_id、name、sort、is_hidden 等字段。查菜单时不能对每个节点都查一次子节点（即 for 循环里调 menuMapper.selectByParentId(id)），否则 5 层深的菜单会触发几十次 SQL。

正确做法是一次性查出全部有效菜单（按角色过滤 + 状态校验），再用 Java 内存组装树：

public List<MenuDTO> buildMenuTree(List<MenuDO> allMenus) {
    Map<Long, MenuDTO> menuMap = allMenus.stream()
        .filter(m -> !m.getIsHidden())
        .collect(Collectors.toMap(MenuDO::getId, this::convertToDTO));
    
    List<MenuDTO> rootList = new ArrayList<>();
    for (MenuDTO node : menuMap.values()) {
        Long parentId = node.getParentId();
        if (parentId == null || parentId == 0 || !menuMap.containsKey(parentId)) {
            rootList.add(node);
        } else {
            menuMap.get(parentId).getChildren().add(node);
        }
    }
    return rootList;
}

• 务必在 SQL 层就用 WHERE role_code IN (...) 或关联 sys_role_menu 表完成权限过滤，不要查全量再 Java 过滤
• sort 字段用于同级排序，组装树后需对每个 children 列表调用 Collections.sort(...)，按 sort 升序
• DTO 中的 children 字段类型必须是 List，不能是 List