本文详解如何在 Laravel Form Request 中通过 unique 规则的复合条件（指定字段 + 忽略 ID）实现“员工 ID + 日期”联合唯一性校验，避免重复录入，同时兼容多员工同日打卡场景。
本文详解如何在 laravel form request 中通过 `unique` 规则的复合条件（指定字段 + 忽略 id）实现“员工 id + 日期”联合唯一性校验，避免重复录入，同时兼容多员工同日打卡场景。
在 Laravel 中，仅使用 'date' => 'unique:worktime,date' 会导致全局日期唯一，无法区分不同员工——这正是你遇到的问题：张三和李四不能在同一天提交记录，显然不符合业务逻辑。正确做法是将唯一性约束升级为组合唯一校验：即“同一 staff_id 下，date 不可重复”。
Laravel 的 unique 规则支持高级语法：unique:table,column,except,idColumn,extraColumn,extraValue
其中关键参数为：
-
except：通常用于编辑场景（跳过当前模型 ID），此处可留空或设为null； -
extraColumn和extraValue：用于添加额外 WHERE 条件，实现联合校验。
因此，你需要动态传入 staff_id 值，使验证规则变为：
✅ “检查 worktime 表中，date 字段值是否已存在，且该记录的 staff_id 等于当前提交的 staff_id”。
但注意：$staff_id 在 rules() 方法中不可直接访问（此时请求数据尚未完全绑定）。正确方式是使用 validationData() 或 request()->get('staff_id')，推荐更安全、更清晰的写法：
public function rules()
{
$staffId = $this->input('staff_id');
return [
'staff_id' => ['required', 'integer', 'exists:staffs,id'],
'date' => [
'required',
'string',
\Illuminate\Validation\Rule::unique('worktime')
->where(fn ($query) => $query->where('staff_id', $staffId))
],
'time_started' => ['required', 'date_format:H:i'],
'time_ended' => ['required', 'date_format:H:i', 'after:time_started'],
];
}✅ 优势说明：
- 使用
Rule::unique()+where()构建闭包查询，语义清晰、类型安全； - 自动处理空值与 SQL 注入防护（Laravel 底层转义）；
- 兼容创建与更新场景（如需更新时跳过自身，可链式调用
ignore($this->id)）。
⚠️ 注意事项：
- 数据库表
worktime上建议为(staff_id, date)添加复合唯一索引，提升查询性能并提供底层数据一致性保障：ALTER TABLE worktime ADD UNIQUE INDEX idx_staff_date (staff_id, date);
- 若
date字段实际存储为DATE类型（非字符串），请确保前端传入格式统一（如Y-m-d），并在验证中使用'date'而非'string'，并配合date_format:Y-m-d校验。
总结：Laravel 完全支持在表单请求验证层实现多字段联合唯一性控制。通过 Rule::unique() 配合 where() 闭包，既能精准表达业务约束，又保持代码可读性与健壮性——无需侵入控制器或手动查库，真正实现声明式、高内聚的验证逻辑。
