142 lines
4.2 KiB
Markdown
142 lines
4.2 KiB
Markdown
# 路由配置完整修复说明
|
||
|
||
## 问题描述
|
||
|
||
当前系统存在以下问题：
|
||
|
||
1. **路由名称不一致**：部分路由使用连字符（如 `user-manage`），部分使用下划线（如 `device_list`）
|
||
2. **组件路径错误**：父路由的组件路径格式不正确，导致前端报错 "Layout component not found"
|
||
3. **角色配置不匹配**：角色的菜单配置与实际路由名称不匹配，导致子菜单无法显示
|
||
|
||
## 修复内容
|
||
|
||
### 1. 路由名称统一（使用下划线）
|
||
|
||
所有路由名称统一使用下划线格式：
|
||
|
||
- `user-manage` → `user_manage`
|
||
- `my-device` → `my_device`
|
||
- `my-application` → `my_application`
|
||
- 子路由：`user_manage_list`, `user_manage_role`, `user_manage_permission` 等
|
||
|
||
### 2. 组件路径修复
|
||
|
||
**父路由**（有子菜单的路由）：
|
||
- 格式：`layout.base$view.{folder-name}`
|
||
- 文件夹名使用连字符（与实际文件夹结构一致）
|
||
- 示例：`layout.base$view.user-manage`, `layout.base$view.my-device`
|
||
|
||
**子路由**（叶子节点）：
|
||
- 格式：`view.{parent-folder}_{child-folder}`
|
||
- 父文件夹用连字符，子文件夹用下划线连接
|
||
- 示例：`view.user-manage_list`, `view.my-device_status`
|
||
|
||
### 3. 角色菜单配置更新
|
||
|
||
更新所有角色的 `menus` 字段，使用正确的路由名称（下划线格式）：
|
||
|
||
**R_SUPER（超级管理员）**：
|
||
```
|
||
device,device_list,device_group,device_monitor,device_online,device_power,
|
||
screen,screen_wall,screen_control,screen_record,
|
||
user_manage,user_manage_list,user_manage_role,user_manage_permission,
|
||
application,application_approval,application_history,
|
||
system,system_agent,system_amt,system_log,
|
||
my_device,my_device_status,my_device_remote,my_device_power,
|
||
my_application,my_application_apply,my_application_list
|
||
```
|
||
|
||
**R_ADMIN（管理员）**：
|
||
```
|
||
device,device_list,device_group,device_monitor,device_online,device_power,
|
||
screen,screen_wall,screen_control,screen_record,
|
||
user_manage,user_manage_list,user_manage_role,
|
||
application,application_approval,application_history
|
||
```
|
||
|
||
**R_USER（普通用户）**：
|
||
```
|
||
my_device,my_device_status,my_device_remote,my_device_power,
|
||
my_application,my_application_apply,my_application_list
|
||
```
|
||
|
||
## 执行步骤
|
||
|
||
### 1. 运行修复脚本
|
||
|
||
双击运行 `fix_user_manage_routes.bat`，或在命令行执行：
|
||
|
||
```bash
|
||
mysql -u root -proot < fix_user_manage_routes.sql
|
||
```
|
||
|
||
### 2. 重启后端服务
|
||
|
||
```bash
|
||
cd backend
|
||
start.bat
|
||
```
|
||
|
||
### 3. 清除浏览器缓存
|
||
|
||
- Chrome: Ctrl + Shift + Delete，选择"缓存的图片和文件"
|
||
- 或使用无痕模式测试
|
||
|
||
### 4. 刷新浏览器
|
||
|
||
按 F5 或 Ctrl + F5 强制刷新页面
|
||
|
||
## 验证结果
|
||
|
||
修复后应该看到：
|
||
|
||
1. ✅ 所有菜单正常显示，无重复
|
||
2. ✅ 用户管理菜单显示三个子菜单：用户列表、角色管理、权限管理
|
||
3. ✅ 控制台无 "Layout component not found" 错误
|
||
4. ✅ 点击菜单可以正常跳转
|
||
|
||
## 技术说明
|
||
|
||
### 路由命名规范
|
||
|
||
- **路由名称（name）**：统一使用下划线，如 `user_manage`, `device_list`
|
||
- **路由路径（path）**：使用连字符，如 `/user-manage`, `/device/list`
|
||
- **文件夹名称**：使用连字符，如 `user-manage/`, `my-device/`
|
||
|
||
### 组件路径规范
|
||
|
||
- **父路由组件**：`layout.base$view.{folder-name}`
|
||
- 必须包含 `layout.base$` 前缀
|
||
- 文件夹名使用连字符
|
||
|
||
- **子路由组件**：`view.{parent-folder}_{child-folder}`
|
||
- 不需要 `layout.base$` 前缀
|
||
- 父子文件夹用下划线连接
|
||
|
||
### 父子关系识别
|
||
|
||
后端通过路径中的斜杠数量判断父子关系：
|
||
- 1个斜杠（如 `/device`）：根路由
|
||
- 2个或以上斜杠（如 `/device/list`）：子路由
|
||
|
||
## 常见问题
|
||
|
||
### Q: 修复后菜单还是显示两次？
|
||
|
||
A: 清除浏览器缓存，或使用无痕模式测试。
|
||
|
||
### Q: 点击菜单报错 "No match for route"？
|
||
|
||
A: 确认路由名称已更新，重启后端服务。
|
||
|
||
### Q: 某些菜单看不到？
|
||
|
||
A: 检查用户的角色配置，确认角色的 `menus` 字段包含对应的路由名称。
|
||
|
||
## 相关文件
|
||
|
||
- `fix_user_manage_routes.sql` - 修复脚本
|
||
- `fix_user_manage_routes.bat` - 执行批处理
|
||
- `backend/src/main/java/com/soybean/admin/service/RouteService.java` - 路由服务
|
||
- `src/store/modules/route/index.ts` - 前端路由存储
|