# 工单查询 JOIN 修复说明

## 问题描述
样品生成工单后，提示"生成成功"，但工单列表中看不到新创建的工单。

## 根本原因
工单查询使用了大量的 `INNER JOIN` 连接用户表和其他关联表。当某些字段的值为 0 或不存在对应记录时（例如 `tester_id=0`），`INNER JOIN` 会过滤掉这些工单，导致查询结果为空。

## 解决方案
将所有 `INNER JOIN` 改为 `LEFT OUTER JOIN`（简写为 `outerjoin`），允许关联表的数据为空。

## 修改内容

### 文件
`ruoyi-fastapi-backend/module_admin/system/dao/test_work_order_dao.py`

### 修改的 JOIN
将以下 JOIN 从 `join` 改为 `outerjoin`：
- Creator (创建人)
- Updater (更新人)
- Tester (测试人)
- Reviewer (一审人)
- SecondTester (二审人)
- ThirdTester (三审人)
- TesterNick (测试人昵称)
- ReviewerNick (一审人昵称)
- SecondTesterNick (二审人昵称)
- ThirdTesterNick (三审人昵称)
- Eut (产品)
- Category (测试类别)
- Item (测试单元)
- ItemTemplate (测试单元模板)

### 代码对比

**修改前**:
```python
.join(Creator, TestWorkOrder.creator == Creator.user_id)
.join(Updater, TestWorkOrder.update_by == Updater.user_id)
.join(Tester, TestWorkOrder.tester_id == Tester.user_id)
# ... 其他 join
```

**修改后**:
```python
.outerjoin(Creator, TestWorkOrder.creator == Creator.user_id)
.outerjoin(Updater, TestWorkOrder.update_by == Updater.user_id)
.outerjoin(Tester, TestWorkOrder.tester_id == Tester.user_id)
# ... 其他 outerjoin
```

## 为什么会出现这个问题

### 样品生成工单时的默认值
在 `warehouse_sample_service.py` 中，创建工单时使用了以下默认值：
```python
tester_id=test_job.tester_id if (test_job and test_job.tester_id) else 0,
reviewer_id=test_job.reviewer_id if (test_job and test_job.reviewer_id) else 0,
second_tester_id=test_job.second_tester_id if (test_job and test_job.second_tester_id) else 0,
third_tester_id=test_job.third_tester_id if (test_job and test_job.third_tester_id) else 0,
```

如果 `test_job` 不存在或者相关字段为空，这些 ID 会被设置为 0。

### INNER JOIN 的行为
当使用 `INNER JOIN` 时：
```sql
SELECT * FROM test_work_order
INNER JOIN sys_user ON test_work_order.tester_id = sys_user.user_id
```

如果 `tester_id = 0` 且 `sys_user` 表中没有 `user_id = 0` 的记录，这条工单就不会出现在查询结果中。

### LEFT OUTER JOIN 的行为
当使用 `LEFT OUTER JOIN` 时：
```sql
SELECT * FROM test_work_order
LEFT OUTER JOIN sys_user ON test_work_order.tester_id = sys_user.user_id
```

即使 `tester_id = 0` 且 `sys_user` 表中没有对应记录，工单仍然会出现在查询结果中，只是关联的用户字段为 NULL。

## 验证步骤

### 1. 重启后端服务
```bash
cd ruoyi-fastapi-backend
# 停止服务
# 启动服务
```

### 2. 测试样品生成工单
1. 进入样品管理页面
2. 选择样品，点击"生成工单"
3. 填写工单信息，提交

### 3. 检查工单列表
1. 进入工单列表页面
2. **验证**: 应该能看到刚才创建的工单
3. **验证**: 工单的用户信息可能为空（如果对应的用户ID不存在）

### 4. 使用 SQL 验证
运行 `check_recent_workorders.sql` 查看最近创建的工单：
```bash
mysql -u root -p your_database < check_recent_workorders.sql
```

## 相关问题

这个问题与之前修复的"订单查询问题"类似：
- **订单查询**: 使用 INNER JOIN 连接用户表，导致某些订单不显示
- **工单查询**: 使用 INNER JOIN 连接用户表和其他表，导致某些工单不显示

**解决方案都是**: 将 INNER JOIN 改为 LEFT OUTER JOIN

## 相关文件
- `ruoyi-fastapi-backend/module_admin/system/dao/test_work_order_dao.py` ✅ 已修复
- `check_recent_workorders.sql` - 检查工单的 SQL 脚本
- `订单查询问题修复说明.md` - 类似问题的修复说明

## 完成时间
2026-01-08