Laravel 中实现带条件的唯一性验证规则教程

本文介绍如何在 laravel 中使用 `rule::unique()` 结合闭包查询，为字段设置带附加条件（如 `rol_usu = 2`）的唯一性验证，避免重复调用数据库或手动写逻辑。

在 Laravel 表单验证中，unique 规则默认仅校验字段在指定表中的全局唯一性。但实际业务中常需「条件唯一」——例如：仅当用户角色为 rol_usu = 2 时，证件号 document_usu 才需保证不重复。此时，直接使用 'unique:users,document_usu' 无法满足需求。

Laravel 提供了灵活的 Illuminate\Validation\Rule 类，支持链式调用 where() 方法，在底层 SQL 查询中动态添加 WHERE 条件。正确写法如下：

use Illuminate\Validation\Rule;

$request->validate([
    'document_usu' => [
        'required',
        Rule::unique('users', 'document_usu')
            ->where(fn ($query) => $query->where('rol_usu', 2)),
    ],
]);

✅ 关键说明：

• Rule::unique('users', 'document_usu') 明确指定表名与字段名（推荐显式传参，增强可读性）；
• ->where() 接收闭包，内部 $query 是 Eloquent 构建器实例，可自由组合条件（如 where('status', 1)->whereNotNull('deleted_at')）；
• 使用箭头函数（fn）可自动绑定 $request 外部变量（若需动态值，如 $request->input('rol_usu')，可 use ($request) 或直接传参）。

⚠️ 注意事项：

• 该规则不适用于批量插入/更新场景（如 insert() 或 upsert()），因验证器在请求层执行，与模型事件解耦；
• 若需排除当前记录（如编辑时允许自身不变），应追加 ->ignore($id, 'id')；
• 数据库字段类型需匹配（如 rol_usu 为整型时，where('rol_usu', '2') 可能失效，建议统一用整数或强制类型转换）。

综上，Rule::unique()->where() 是实现多条件唯一验证的标准、安全且可维护的方式，既保持验证逻辑集中于请求层，又充分利用 Laravel 的查询构造能力。