402 lines
8.9 KiB
Markdown
402 lines
8.9 KiB
Markdown
# 预约时段为空问题诊断指南
|
||
|
||
## 问题描述
|
||
|
||
访问接口 `/adminapi/doctor.appointment/availableSlots?doctor_id=3&appointment_date=2026-03-06&period=all` 返回空数组。
|
||
|
||
## 可能的原因
|
||
|
||
### 原因 1：医生没有排班数据
|
||
|
||
**检查方法：**
|
||
```sql
|
||
SELECT * FROM zyt_doctor_roster
|
||
WHERE doctor_id = 3
|
||
AND date = '2026-03-06';
|
||
```
|
||
|
||
**如果返回空：**
|
||
- 说明医生在该日期没有排班
|
||
- 需要先添加排班数据
|
||
|
||
**解决方案：**
|
||
```sql
|
||
-- 添加排班数据
|
||
INSERT INTO zyt_doctor_roster (
|
||
doctor_id,
|
||
date,
|
||
period,
|
||
status,
|
||
quota,
|
||
max_patients,
|
||
booked_count,
|
||
create_time,
|
||
update_time
|
||
) VALUES
|
||
(3, '2026-03-06', 1, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()), -- 上午出诊
|
||
(3, '2026-03-06', 2, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()); -- 下午出诊
|
||
```
|
||
|
||
### 原因 2：排班状态不是"出诊"
|
||
|
||
**检查方法：**
|
||
```sql
|
||
SELECT
|
||
id,
|
||
date,
|
||
period,
|
||
status,
|
||
CASE status
|
||
WHEN 1 THEN '出诊'
|
||
WHEN 2 THEN '停诊'
|
||
WHEN 3 THEN '休息'
|
||
WHEN 4 THEN '请假'
|
||
END as status_name
|
||
FROM zyt_doctor_roster
|
||
WHERE doctor_id = 3
|
||
AND date = '2026-03-06';
|
||
```
|
||
|
||
**如果 status 不是 1：**
|
||
- status = 2（停诊）→ 不会生成时段
|
||
- status = 3（休息）→ 不会生成时段
|
||
- status = 4（请假）→ 不会生成时段
|
||
|
||
**解决方案：**
|
||
```sql
|
||
-- 修改排班状态为出诊
|
||
UPDATE zyt_doctor_roster
|
||
SET status = 1
|
||
WHERE doctor_id = 3
|
||
AND date = '2026-03-06';
|
||
```
|
||
|
||
### 原因 3：period 值不正确
|
||
|
||
**检查方法：**
|
||
```sql
|
||
SELECT
|
||
id,
|
||
date,
|
||
period,
|
||
CASE period
|
||
WHEN 1 THEN '上午'
|
||
WHEN 2 THEN '下午'
|
||
ELSE CONCAT('未知(', period, ')')
|
||
END as period_name,
|
||
status
|
||
FROM zyt_doctor_roster
|
||
WHERE doctor_id = 3
|
||
AND date = '2026-03-06';
|
||
```
|
||
|
||
**如果 period 不是 1 或 2：**
|
||
- 代码只处理 period = 1（上午）和 period = 2（下午）
|
||
- 其他值会被跳过
|
||
|
||
**解决方案：**
|
||
```sql
|
||
-- 修改 period 为正确的值
|
||
UPDATE zyt_doctor_roster
|
||
SET period = 1 -- 或 2
|
||
WHERE doctor_id = 3
|
||
AND date = '2026-03-06'
|
||
AND period NOT IN (1, 2);
|
||
```
|
||
|
||
### 原因 4：医生ID不存在
|
||
|
||
**检查方法：**
|
||
```sql
|
||
-- 检查医生是否存在
|
||
SELECT
|
||
a.id,
|
||
a.name,
|
||
a.account,
|
||
ar.role_id
|
||
FROM zyt_admin a
|
||
INNER JOIN zyt_admin_role ar ON a.id = ar.admin_id
|
||
WHERE a.id = 3
|
||
AND ar.role_id = 1;
|
||
```
|
||
|
||
**如果返回空：**
|
||
- 医生ID=3不存在
|
||
- 或者该用户不是医生角色
|
||
|
||
## 快速诊断步骤
|
||
|
||
### 步骤 1：检查排班数据
|
||
|
||
```sql
|
||
SELECT
|
||
id,
|
||
doctor_id,
|
||
date,
|
||
period,
|
||
CASE period
|
||
WHEN 1 THEN '上午'
|
||
WHEN 2 THEN '下午'
|
||
ELSE '未知'
|
||
END as period_name,
|
||
status,
|
||
CASE status
|
||
WHEN 1 THEN '出诊'
|
||
WHEN 2 THEN '停诊'
|
||
WHEN 3 THEN '休息'
|
||
WHEN 4 THEN '请假'
|
||
ELSE '未知'
|
||
END as status_name
|
||
FROM zyt_doctor_roster
|
||
WHERE doctor_id = 3
|
||
AND date = '2026-03-06';
|
||
```
|
||
|
||
**预期结果：**
|
||
```
|
||
+----+-----------+------------+--------+-------------+--------+-------------+
|
||
| id | doctor_id | date | period | period_name | status | status_name |
|
||
+----+-----------+------------+--------+-------------+--------+-------------+
|
||
| 1 | 3 | 2026-03-06 | 1 | 上午 | 1 | 出诊 |
|
||
| 2 | 3 | 2026-03-06 | 2 | 下午 | 1 | 出诊 |
|
||
+----+-----------+------------+--------+-------------+--------+-------------+
|
||
```
|
||
|
||
### 步骤 2：查看日志
|
||
|
||
```bash
|
||
# 查看应用日志
|
||
tail -f runtime/log/202403/04.log | grep "获取可用时段"
|
||
```
|
||
|
||
**日志示例：**
|
||
```
|
||
[info] 获取可用时段 - 请求参数 {"doctor_id":3,"date":"2026-03-06","period":"all"}
|
||
[info] 查询到的排班数据 {"count":2,"rosters":[...]}
|
||
[info] 处理排班时段 {"roster_id":1,"period":1}
|
||
[info] 处理排班时段 {"roster_id":2,"period":2}
|
||
[info] 生成的时间段数量 {"count":28}
|
||
```
|
||
|
||
### 步骤 3：测试接口
|
||
|
||
```bash
|
||
# 使用 curl 测试
|
||
curl -X GET "http://your-domain/adminapi/doctor.appointment/availableSlots?doctor_id=3&appointment_date=2026-03-06&period=all" \
|
||
-H "token: your-token"
|
||
```
|
||
|
||
**预期响应（有排班）：**
|
||
```json
|
||
{
|
||
"code": 1,
|
||
"msg": "success",
|
||
"data": {
|
||
"slots": [
|
||
{"time": "09:00", "available": true, "quota": 1, "period": 1},
|
||
{"time": "09:15", "available": true, "quota": 1, "period": 1},
|
||
...
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
**实际响应（无排班）：**
|
||
```json
|
||
{
|
||
"code": 1,
|
||
"msg": "success",
|
||
"data": {
|
||
"slots": []
|
||
}
|
||
}
|
||
```
|
||
|
||
## 解决方案
|
||
|
||
### 方案 1：添加排班数据
|
||
|
||
如果医生没有排班，需要先添加：
|
||
|
||
```sql
|
||
-- 添加2026-03-06的排班
|
||
INSERT INTO zyt_doctor_roster (
|
||
doctor_id,
|
||
date,
|
||
period,
|
||
status,
|
||
quota,
|
||
max_patients,
|
||
booked_count,
|
||
remark,
|
||
create_time,
|
||
update_time
|
||
) VALUES
|
||
-- 上午出诊
|
||
(3, '2026-03-06', 1, 1, 20, 20, 0, '上午出诊', UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
|
||
-- 下午出诊
|
||
(3, '2026-03-06', 2, 1, 20, 20, 0, '下午出诊', UNIX_TIMESTAMP(), UNIX_TIMESTAMP());
|
||
```
|
||
|
||
### 方案 2：修改排班状态
|
||
|
||
如果排班存在但状态不对：
|
||
|
||
```sql
|
||
-- 将休息/停诊改为出诊
|
||
UPDATE zyt_doctor_roster
|
||
SET status = 1,
|
||
update_time = UNIX_TIMESTAMP()
|
||
WHERE doctor_id = 3
|
||
AND date = '2026-03-06'
|
||
AND status != 1;
|
||
```
|
||
|
||
### 方案 3：批量添加排班
|
||
|
||
为医生添加未来7天的排班：
|
||
|
||
```sql
|
||
-- 添加未来7天的排班
|
||
INSERT INTO zyt_doctor_roster (
|
||
doctor_id,
|
||
date,
|
||
period,
|
||
status,
|
||
quota,
|
||
max_patients,
|
||
booked_count,
|
||
create_time,
|
||
update_time
|
||
) VALUES
|
||
-- 2026-03-04
|
||
(3, '2026-03-04', 1, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
|
||
(3, '2026-03-04', 2, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
|
||
-- 2026-03-05
|
||
(3, '2026-03-05', 1, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
|
||
(3, '2026-03-05', 2, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
|
||
-- 2026-03-06
|
||
(3, '2026-03-06', 1, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
|
||
(3, '2026-03-06', 2, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
|
||
-- 2026-03-07
|
||
(3, '2026-03-07', 1, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
|
||
(3, '2026-03-07', 2, 3, 0, 0, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()), -- 下午休息
|
||
-- 2026-03-08
|
||
(3, '2026-03-08', 1, 3, 0, 0, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()), -- 上午休息
|
||
(3, '2026-03-08', 2, 3, 0, 0, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()), -- 下午休息
|
||
-- 2026-03-09
|
||
(3, '2026-03-09', 1, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
|
||
(3, '2026-03-09', 2, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
|
||
-- 2026-03-10
|
||
(3, '2026-03-10', 1, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP()),
|
||
(3, '2026-03-10', 2, 1, 20, 20, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP());
|
||
```
|
||
|
||
## 验证修复
|
||
|
||
### 1. 检查数据
|
||
|
||
```sql
|
||
SELECT
|
||
date,
|
||
period,
|
||
CASE period WHEN 1 THEN '上午' WHEN 2 THEN '下午' END as period_name,
|
||
status,
|
||
CASE status WHEN 1 THEN '出诊' WHEN 2 THEN '停诊' WHEN 3 THEN '休息' END as status_name
|
||
FROM zyt_doctor_roster
|
||
WHERE doctor_id = 3
|
||
AND date BETWEEN '2026-03-04' AND '2026-03-10'
|
||
ORDER BY date, period;
|
||
```
|
||
|
||
### 2. 测试接口
|
||
|
||
```bash
|
||
curl -X GET "http://your-domain/adminapi/doctor.appointment/availableSlots?doctor_id=3&appointment_date=2026-03-06&period=all" \
|
||
-H "token: your-token"
|
||
```
|
||
|
||
### 3. 前端测试
|
||
|
||
1. 登录管理后台
|
||
2. 进入诊单管理
|
||
3. 点击"挂号"
|
||
4. 选择医生ID=3
|
||
5. 选择日期2026-03-06
|
||
6. 查看是否显示时段
|
||
|
||
## 常见错误
|
||
|
||
### 错误 1：日期格式不对
|
||
|
||
```sql
|
||
-- ❌ 错误：使用了错误的日期格式
|
||
INSERT INTO zyt_doctor_roster (doctor_id, date, ...)
|
||
VALUES (3, '2026/03/06', ...);
|
||
|
||
-- ✅ 正确：使用 YYYY-MM-DD 格式
|
||
INSERT INTO zyt_doctor_roster (doctor_id, date, ...)
|
||
VALUES (3, '2026-03-06', ...);
|
||
```
|
||
|
||
### 错误 2：status 值错误
|
||
|
||
```sql
|
||
-- ❌ 错误：使用了字符串
|
||
UPDATE zyt_doctor_roster SET status = '出诊';
|
||
|
||
-- ✅ 正确：使用数字
|
||
UPDATE zyt_doctor_roster SET status = 1;
|
||
```
|
||
|
||
### 错误 3：period 值错误
|
||
|
||
```sql
|
||
-- ❌ 错误：使用了字符串
|
||
INSERT INTO zyt_doctor_roster (period, ...) VALUES ('上午', ...);
|
||
|
||
-- ✅ 正确：使用数字
|
||
INSERT INTO zyt_doctor_roster (period, ...) VALUES (1, ...);
|
||
```
|
||
|
||
## 调试工具
|
||
|
||
### 使用提供的SQL脚本
|
||
|
||
```bash
|
||
# 在数据库客户端中运行
|
||
source CHECK_ROSTER_DATA.sql
|
||
```
|
||
|
||
### 查看详细日志
|
||
|
||
代码中已添加详细日志，可以通过以下方式查看：
|
||
|
||
```bash
|
||
# 实时查看日志
|
||
tail -f runtime/log/202403/04.log
|
||
|
||
# 搜索特定医生的日志
|
||
grep "doctor_id.*3" runtime/log/202403/04.log
|
||
|
||
# 搜索特定日期的日志
|
||
grep "2026-03-06" runtime/log/202403/04.log
|
||
```
|
||
|
||
## 总结
|
||
|
||
最常见的原因是：
|
||
1. ✅ 医生没有排班数据
|
||
2. ✅ 排班状态不是"出诊"（status != 1）
|
||
3. ✅ period 值不是 1 或 2
|
||
|
||
解决方法：
|
||
1. 添加排班数据
|
||
2. 修改排班状态为出诊（status = 1）
|
||
3. 确保 period 值为 1（上午）或 2（下午）
|
||
|
||
---
|
||
|
||
**创建日期：** 2024-03-04
|
||
**版本：** 1.0
|