/** * 菜单处理器 * * 负责菜单数据的获取、过滤和处理 * * @module router/core/MenuProcessor * @author Art Design Pro Team */ import type { AppRouteRecord } from '@/types/router' import { useUserStore } from '@/store/modules/user' import { useAppMode } from '@/hooks/core/useAppMode' import { fetchGetMenuList } from '@/api/system-manage' import { fetchGetMenuCodes } from '@/api/auth' import { asyncRoutes } from '../routes/asyncRoutes' import { RoutesAlias } from '../routesAlias' import { formatMenuTitle } from '@/utils' export class MenuProcessor { /** * 将路由上的“菜单标识”规范化为数据库/权限体系使用的 code 形态。 * 例如:DeliveryList -> delivery_list */ private normalizeMenuCode(input: unknown): string { const raw = String(input ?? '').trim() if (!raw) return '' // 兼容已是 snake_case 的情况 const withUnderscore = raw .replace(/[\s-]+/g, '_') // PascalCase / camelCase -> snake_case .replace(/([a-z0-9])([A-Z])/g, '$1_$2') return withUnderscore.toLowerCase() } /** * 获取菜单数据 */ async getMenuList(): Promise { const { isFrontendMode } = useAppMode() let menuList: AppRouteRecord[] if (isFrontendMode.value) { menuList = await this.processFrontendMenu() } else { menuList = await this.processBackendMenu() } // 在规范化路径之前,验证原始路径配置 this.validateMenuPaths(menuList) // 规范化路径(将相对路径转换为完整路径) return this.normalizeMenuPaths(menuList) } /** * 处理前端控制模式的菜单 */ private async processFrontendMenu(): Promise { const userStore = useUserStore() const info = userStore.info const roles = info?.roles?.length ? info.roles : info?.role ? [info.role] : undefined let menuList = [...asyncRoutes] // 根据角色过滤菜单 if (roles && roles.length > 0) { // super_admin:前端静态菜单全量展示,不依赖 meta.roles 的维护 if (!roles.includes('super_admin')) { menuList = this.filterMenuByRoles(menuList, roles) } } // 静态菜单模式下,admin 按后端返回的 menuCodes 过滤菜单 if (info?.role === 'admin') { const perm = await fetchGetMenuCodes() const codeSet = new Set( (perm?.menuCodes || []).map((x) => this.normalizeMenuCode(x)).filter(Boolean) ) if (!perm?.all) { menuList = this.filterMenuByCodes(menuList, codeSet) } } return this.filterEmptyMenus(menuList) } /** * 处理后端控制模式的菜单 */ private async processBackendMenu(): Promise { const list = await fetchGetMenuList() return this.filterEmptyMenus(list) } /** * 根据角色过滤菜单 */ private filterMenuByRoles(menu: AppRouteRecord[], roles: string[]): AppRouteRecord[] { return menu.reduce((acc: AppRouteRecord[], item) => { const itemRoles = item.meta?.roles const hasPermission = !itemRoles || itemRoles.some((role) => roles?.includes(role)) if (hasPermission) { const filteredItem = { ...item } if (filteredItem.children?.length) { filteredItem.children = this.filterMenuByRoles(filteredItem.children, roles) } acc.push(filteredItem) } return acc }, []) } /** * 根据 menu code 过滤菜单(仅补齐顶级父菜单) */ private filterMenuByCodes( menu: AppRouteRecord[], codes: Set, level = 1 ): AppRouteRecord[] { return menu.reduce((acc: AppRouteRecord[], item) => { const rawCode = (item.meta as any)?.menuCode ?? item.name const code = this.normalizeMenuCode(rawCode) const hasSelfPermission = !!code && codes.has(code) const filteredChildren = item.children?.length ? this.filterMenuByCodes(item.children, codes, level + 1) : item.children const shouldKeep = hasSelfPermission || (level === 1 && Array.isArray(filteredChildren) && filteredChildren.length > 0) if (shouldKeep) { acc.push({ ...item, children: filteredChildren }) } return acc }, []) } /** * 递归过滤空菜单项 */ private filterEmptyMenus(menuList: AppRouteRecord[]): AppRouteRecord[] { return menuList .map((item) => { // 如果有子菜单,先递归过滤子菜单 if (item.children && item.children.length > 0) { const filteredChildren = this.filterEmptyMenus(item.children) return { ...item, children: filteredChildren } } return item }) .filter((item) => { // 如果定义了 children 属性(即使是空数组),说明这是一个目录菜单,应该保留 if ('children' in item) { return true } // 如果有外链或 iframe,保留 if (item.meta?.isIframe === true || item.meta?.link) { return true } // 如果有有效的 component,保留 if (item.component && item.component !== '' && item.component !== RoutesAlias.Layout) { return true } // 其他情况过滤掉 return false }) } /** * 验证菜单列表是否有效 */ validateMenuList(menuList: AppRouteRecord[]): boolean { return Array.isArray(menuList) && menuList.length > 0 } /** * 规范化菜单路径 * 将相对路径转换为完整路径,确保菜单跳转正确 */ private normalizeMenuPaths(menuList: AppRouteRecord[], parentPath = ''): AppRouteRecord[] { return menuList.map((item) => { // 构建完整路径 const fullPath = this.buildFullPath(item.path || '', parentPath) // 递归处理子菜单 const children = item.children?.length ? this.normalizeMenuPaths(item.children, fullPath) : item.children const redirect = item.redirect || this.resolveDefaultRedirect(children) return { ...item, path: fullPath, redirect, children } }) } /** * 为目录型菜单推导默认跳转地址 */ private resolveDefaultRedirect(children?: AppRouteRecord[]): string | undefined { if (!children?.length) { return undefined } for (const child of children) { if (this.isNavigableRoute(child)) { return child.path } const nestedRedirect = this.resolveDefaultRedirect(child.children) if (nestedRedirect) { return nestedRedirect } } return undefined } /** * 判断子路由是否可以作为默认落点 */ private isNavigableRoute(route: AppRouteRecord): boolean { return Boolean( route.path && route.path !== '/' && !route.meta?.link && route.meta?.isIframe !== true && route.component && route.component !== '' ) } /** * 验证菜单路径配置 * 检测非一级菜单是否错误使用了 / 开头的路径 */ /** * 验证菜单路径配置 * 检测非一级菜单是否错误使用了 / 开头的路径 */ private validateMenuPaths(menuList: AppRouteRecord[], level = 1): void { menuList.forEach((route) => { if (!route.children?.length) return const parentName = String(route.name || route.path || '未知路由') route.children.forEach((child) => { const childPath = child.path || '' // 跳过合法的绝对路径:外部链接和 iframe 路由 if (this.isValidAbsolutePath(childPath)) return // 检测非法的绝对路径 if (childPath.startsWith('/')) { this.logPathError(child, childPath, parentName, level) } }) // 递归检查更深层级的子路由 this.validateMenuPaths(route.children, level + 1) }) } /** * 判断是否为合法的绝对路径 */ private isValidAbsolutePath(path: string): boolean { return ( path.startsWith('http://') || path.startsWith('https://') || path.startsWith('/outside/iframe/') ) } /** * 输出路径配置错误日志 */ private logPathError( route: AppRouteRecord, path: string, parentName: string, level: number ): void { const routeName = String(route.name || path || '未知路由') const menuTitle = route.meta?.title || routeName const suggestedPath = path.split('/').pop() || path.slice(1) console.error( `[路由配置错误] 菜单 "${formatMenuTitle(menuTitle)}" (name: ${routeName}, path: ${path}) 配置错误\n` + ` 位置: ${parentName} > ${routeName}\n` + ` 问题: ${level + 1}级菜单的 path 不能以 / 开头\n` + ` 当前配置: path: '${path}'\n` + ` 应该改为: path: '${suggestedPath}'` ) } /** * 构建完整路径 */ private buildFullPath(path: string, parentPath: string): string { if (!path) return '' // 外部链接直接返回 if (path.startsWith('http://') || path.startsWith('https://')) { return path } // 如果已经是绝对路径,直接返回 if (path.startsWith('/')) { return path } // 拼接父路径和当前路径 if (parentPath) { // 移除父路径末尾的斜杠,移除子路径开头的斜杠,然后拼接 const cleanParent = parentPath.replace(/\/$/, '') const cleanChild = path.replace(/^\//, '') return `${cleanParent}/${cleanChild}` } // 没有父路径,添加前导斜杠 return `/${path}` } }