refactor: integrate getMenuKey for consistent menu item handling

- Introduced the getMenuKey utility to standardize menu item keys, ensuring compatibility with dynamic routing and menu state management.
- Updated menu item construction in buildMenuItems to utilize the new key, enhancing the accuracy of selected and open menu states.
- Adjusted resolveMenuSelection to align with the new key structure, improving the reliability of menu expansion after refresh.

Author: windbytes

src/layouts/LeftMenu/component/menu-utils.ts

@@ -4,7 +4,7 @@ import type { Key, ReactNode } from 'react';
 
 import type { RouteItem } from '@/types/route';
 import { getIcon } from '@/utils/optimized-icons';
-import { type MenuCaches, matchPathname, matchRoutePath } from '@/utils/utils';
+import { getMenuKey, type MenuCaches, matchPathname, matchRoutePath } from '@/utils/utils';
 
 export type MenuItem = Required<MenuProps>['items'][number];
 
@@ -178,12 +178,13 @@ export const buildMenuItems = (menuList: RouteItem[], t: TFunction): MenuItem[]
       continue;
     }
 
+    const key = getMenuKey(item);
     if (!item?.children?.length) {
-      result.push(getItem(t, item.meta?.title, item.path, getIcon(item.meta?.icon)));
+      result.push(getItem(t, item.meta?.title, key, getIcon(item.meta?.icon)));
       continue;
     }
 
-    result.push(getItem(t, item.meta?.title, item.path, getIcon(item.meta?.icon), buildMenuItems(item.children, t)));
+    result.push(getItem(t, item.meta?.title, key, getIcon(item.meta?.icon), buildMenuItems(item.children, t)));
   }
 
   return result;
@@ -231,6 +232,7 @@ export const hasRoutePath = (routes: RouteItem[] | undefined, targetPath: string
  * 根据 pathname 决定选中/展开的菜单 path。
  * 若命中纯路由节点，则退回最近的可见菜单。
  * 若完全未命中，则尝试做动态匹配。
+ * openKeys 使用 getMenuKey 与侧栏菜单项 key 一致，保证刷新后父级能正确展开。
  */
 export function resolveMenuSelection(
   pathname: string,
@@ -255,7 +257,9 @@ export function resolveMenuSelection(
     return { selectedPath: null, openKeys: [] };
   }
 
-  // 纯路由回退到最近的可见菜单 path
+  const menuKey = getMenuKey(entity);
+
+  // 纯路由回退到最近的可见菜单（fallback 为父级的 menuKey）
   if (entity.meta?.menuType === 2 || entity.hidden) {
     const fallback = routeToMenuPathMap.get(targetPath);
     if (!fallback) {
@@ -268,7 +272,7 @@ export function resolveMenuSelection(
   }
 
   return {
-    selectedPath: entity.path,
-    openKeys: ancestorsMap.get(entity.path) ?? [],
+    selectedPath: menuKey,
+    openKeys: ancestorsMap.get(menuKey) ?? [],
   };
 }

src/utils/utils.tsx

@@ -15,6 +15,19 @@ export type MenuCaches = {
   routeToMenuPathMap: Map<string, string>;
 };
 
+/**
+ * 菜单项在侧栏中使用的稳定 key（与 path 可能为空的一级菜单兼容）
+ * 用于 ancestorsMap、Menu openKeys 与菜单项 key 一致，保证刷新后父级能正确展开
+ */
+export function getMenuKey(node: { path?: string; id?: string; redirect?: string }): string {
+  const path = node.path?.trim();
+  if (path) return path;
+  if (node.id) return String(node.id);
+  const redirect = node.redirect?.trim();
+  if (redirect) return redirect;
+  return String(node.id ?? '');
+}
+
 /**
  * Add the object as a parameter to the URL
  * @param baseUrl url
@@ -201,25 +214,26 @@ export function buildMenuCaches(menuList: MenuEntity[]): MenuCaches {
 
   const dfs = (node: MenuEntity, parentVisibleAncestors: string[]) => {
     const isPureRoute = node.meta?.menuType === 2;
+    const menuKey = getMenuKey(node);
 
-    // 可见菜单：自身 path 是 key；隐藏/纯路由：仅记录 pathMap 方便匹配
-    pathMap.set(node.path, node);
+    // pathMap 仅用 path 注册，供 pathname 匹配；有 path 的节点才参与路径查找
+    if (node.path?.trim()) {
+      pathMap.set(node.path.trim(), node);
+    }
 
     if (!isPureRoute && !node.hidden) {
-      ancestorsMap.set(node.path, [...parentVisibleAncestors]);
+      ancestorsMap.set(menuKey, [...parentVisibleAncestors]);
     }
 
     if (isPureRoute) {
-      // 路由节点指向最近的可见菜单
       const nearestVisible = parentVisibleAncestors[parentVisibleAncestors.length - 1];
-      if (nearestVisible) {
-        routeToMenuPathMap.set(node.path, nearestVisible);
+      if (nearestVisible && node.path?.trim()) {
+        routeToMenuPathMap.set(node.path.trim(), nearestVisible);
       }
     }
 
-    // 计算下一层可见菜单的父链
     const nextVisibleAncestors =
-      isPureRoute || node.hidden ? parentVisibleAncestors : [...parentVisibleAncestors, node.path];
+      isPureRoute || node.hidden ? parentVisibleAncestors : [...parentVisibleAncestors, menuKey];
 
     node.children?.forEach((child) => {
       dfs(child, nextVisibleAncestors);