Laravel8实现同医生同工作日排班时段重叠拦截的方案咨询

核心逻辑说明 #

两个时间段存在冲突的判断规则：新排班的开始时间 < 已有排班的结束时间 且 新排班的结束时间 > 已有排班的开始时间。该规则覆盖所有重叠场景：

• 新排班完全落在已有排班范围内
• 新排班头部与已有排班尾部重叠
• 新排班尾部与已有排班头部重叠
• 新排班完全覆盖已有排班

如果业务允许时段无缝衔接（如新排班开始时间正好等于已有排班结束时间不算冲突），可将判断条件中的 </> 调整为 <=/>=。

实现步骤 #

1. 优先使用SQL直接校验（性能最优） #

无需先查询出全部已有排班再遍历判断，直接通过查询条件判断是否存在冲突记录，减少IO和内存消耗：

// 接收请求参数
$doctorId = $request->input('doctor_id');
$day = $request->input('day');
$newStart = $request->input('start_time');
$newEnd = $request->input('end_time');

// 校验是否存在冲突排班
$hasConflict = Schedule::where('doctor_id', $doctorId)
    ->where('day', $day)
    // 冲突判断条件
    ->where('start_time', '<', $newEnd)
    ->where('end_time', '>', $newStart)
    ->exists();

if ($hasConflict) {
    // 存在冲突，返回错误提示
    return back()->withErrors(['msg' => '该时段与已有排班冲突，请调整时间后重试']);
}

// 无冲突，执行创建逻辑
Schedule::create($request->validated());

2. 集成到表单验证规则（更规范） #

如果使用Laravel的表单请求类验证，可以直接把冲突校验写成闭包规则，统一校验逻辑：

// 表单请求类的rules方法
public function rules()
{
    return [
        'doctor_id' => 'required|exists:doctors,id',
        'day' => 'required|string',
        'start_time' => 'required|date_format:h:i:s a',
        'end_time' => 'required|date_format:h:i:s a|after:start_time',
        // 冲突校验规则
        'start_time' => function ($attribute, $value, $fail) {
            $hasConflict = Schedule::where('doctor_id', $this->input('doctor_id'))
                ->where('day', $this->input('day'))
                ->where('start_time', '<', $this->input('end_time'))
                ->where('end_time', '>', $value)
                ->exists();
            
            if ($hasConflict) {
                $fail('该时段与已有排班冲突，请调整时间后重试');
            }
        },
    ];
}

注意事项 #

• 建议schedules表的start_time和end_time字段使用time类型存储，数据库层面时间比较更准确
• 12小时制的时间字符串Laravel底层Carbon可以正常解析，无需额外转换，如果业务有特殊格式可先通过Carbon::createFromFormat解析后再传入查询条件
• 高并发场景下可配合数据库唯一索引或者事务加锁避免同时提交的冲突请求漏判

内容的提问来源于stack exchange，提问作者Debjit Paul