143 lines
4.1 KiB
Markdown
143 lines
4.1 KiB
Markdown
|
# 工单菜单路径配置错误修复说明
|
|||
|
|
|
|||
|
|
## 问题根源
|
|||
|
|
找到了路由跳转问题的真正原因！问题出在**数据库菜单配置**中。
|
|||
|
|
|
|||
|
|
### 错误的菜单配置
|
|||
|
|
```
|
|||
|
|
工单管理（父菜单）
|
|||
|
|
├─ menu_id: 2098
|
|||
|
|
├─ menu_name: 工单管理
|
|||
|
|
├─ path: testWorkOrder ❌ 错误！应该是 test_work_order
|
|||
|
|
└─ menu_type: M (目录)
|
|||
|
|
|
|||
|
|
测试工单（子菜单）
|
|||
|
|
├─ menu_id: 2092
|
|||
|
|
├─ menu_name: 测试工单
|
|||
|
|
├─ path: test_work_order ✅ 正确
|
|||
|
|
├─ component: system/test_work_order/index ✅ 正确
|
|||
|
|
└─ menu_type: C (菜单)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 问题分析
|
|||
|
|
1. **父菜单路径错误**：`testWorkOrder`（驼峰命名）
|
|||
|
|
2. **子菜单路径正确**：`test_work_order`（下划线命名）
|
|||
|
|
3. **路径不一致**导致路由匹配混乱
|
|||
|
|
|
|||
|
|
当点击"测试中"按钮时，Vue Router 尝试匹配路由，但由于父菜单路径是 `testWorkOrder`，导致生成了错误的 URL：
|
|||
|
|
```
|
|||
|
|
http://127.0.0.1/testWorkOrder/testOrder01?page=work_order&state=0
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 修复方案
|
|||
|
|
|
|||
|
|
### 方法1：执行SQL脚本（推荐）
|
|||
|
|
运行 `fix_workorder_menu_path.sql` 脚本：
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
UPDATE sys_menu
|
|||
|
|
SET
|
|||
|
|
path = 'test_work_order',
|
|||
|
|
update_time = NOW()
|
|||
|
|
WHERE menu_id = 2098;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 方法2：在后台管理界面修改
|
|||
|
|
1. 登录后台管理系统
|
|||
|
|
2. 进入"系统管理" -> "菜单管理"
|
|||
|
|
3. 找到"工单管理"菜单（menu_id: 2098）
|
|||
|
|
4. 点击"修改"
|
|||
|
|
5. 将"路由地址"从 `testWorkOrder` 改为 `test_work_order`
|
|||
|
|
6. 点击"确定"保存
|
|||
|
|
|
|||
|
|
## 修复步骤
|
|||
|
|
|
|||
|
|
### 1. 执行SQL修复脚本
|
|||
|
|
```bash
|
|||
|
|
mysql -h127.0.0.1 -P3306 -uroot -p123456 ry-fastapi < fix_workorder_menu_path.sql
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 清除后端缓存
|
|||
|
|
如果后端有菜单缓存，需要重启后端服务：
|
|||
|
|
```bash
|
|||
|
|
# 停止后端服务
|
|||
|
|
# 重新启动后端服务
|
|||
|
|
cd ruoyi-fastapi-backend
|
|||
|
|
python main.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 清除前端缓存
|
|||
|
|
- 按 `Ctrl + Shift + R` 强制刷新页面
|
|||
|
|
- 或者清除浏览器缓存
|
|||
|
|
|
|||
|
|
### 4. 重新登录
|
|||
|
|
- 退出当前登录
|
|||
|
|
- 重新登录系统
|
|||
|
|
- 这样可以重新加载菜单配置
|
|||
|
|
|
|||
|
|
## 验证步骤
|
|||
|
|
|
|||
|
|
### 1. 检查菜单配置
|
|||
|
|
```sql
|
|||
|
|
SELECT
|
|||
|
|
menu_id,
|
|||
|
|
menu_name,
|
|||
|
|
parent_id,
|
|||
|
|
path,
|
|||
|
|
component,
|
|||
|
|
menu_type
|
|||
|
|
FROM sys_menu
|
|||
|
|
WHERE menu_id IN (2098, 2092);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
预期结果：
|
|||
|
|
```
|
|||
|
|
menu_id | menu_name | parent_id | path | component | menu_type
|
|||
|
|
--------|-----------|-----------|-----------------|--------------------------------|----------
|
|||
|
|
2098 | 工单管理 | 0 | test_work_order | (空) | M
|
|||
|
|
2092 | 测试工单 | 2098 | test_work_order | system/test_work_order/index | C
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 测试路由跳转
|
|||
|
|
1. 访问工单管理页面
|
|||
|
|
2. URL 应该是：`http://127.0.0.1/system/test_work_order`
|
|||
|
|
3. 点击"测试中"按钮
|
|||
|
|
4. URL 应该保持不变
|
|||
|
|
5. 数据列表正确显示 testStep=1 的工单
|
|||
|
|
|
|||
|
|
## 为什么会出现这个问题？
|
|||
|
|
|
|||
|
|
### 命名规范不一致
|
|||
|
|
- **数据库表名**：使用下划线命名 `test_work_order`
|
|||
|
|
- **前端组件路径**：使用下划线命名 `system/test_work_order/index`
|
|||
|
|
- **菜单路径**：应该使用下划线命名 `test_work_order`
|
|||
|
|
- **错误配置**：使用了驼峰命名 `testWorkOrder`
|
|||
|
|
|
|||
|
|
### 建议的命名规范
|
|||
|
|
在整个系统中统一使用下划线命名：
|
|||
|
|
- 数据库表名：`test_work_order`
|
|||
|
|
- API路径：`/system/test_work_order`
|
|||
|
|
- 前端路由：`/system/test_work_order`
|
|||
|
|
- 菜单路径：`test_work_order`
|
|||
|
|
- 组件路径：`system/test_work_order/index`
|
|||
|
|
|
|||
|
|
## 相关文件
|
|||
|
|
- `fix_workorder_menu_path.sql` - SQL修复脚本
|
|||
|
|
- `check_menu_routes.sql` - 菜单配置查询脚本
|
|||
|
|
- `工单页面路由跳转问题诊断.md` - 详细诊断文档
|
|||
|
|
- `工单页面路由跳转问题修复说明.md` - 之前的修复说明（删除了错误的路由配置）
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
1. **必须修改数据库菜单配置**：这是问题的根源
|
|||
|
|
2. **必须重新登录**：菜单配置在登录时加载
|
|||
|
|
3. **必须清除缓存**：前端和后端都可能有缓存
|
|||
|
|
4. **检查其他菜单**：确保其他菜单的路径配置也是正确的
|
|||
|
|
|
|||
|
|
## 完整的修复清单
|
|||
|
|
- [x] 删除 router/index.js 中的错误路由配置
|
|||
|
|
- [ ] 修改数据库菜单配置（menu_id: 2098）
|
|||
|
|
- [ ] 重启后端服务
|
|||
|
|
- [ ] 清除浏览器缓存
|
|||
|
|
- [ ] 重新登录系统
|
|||
|
|
- [ ] 测试路由跳转功能
|