Laravel唯一验证规则使用教程

最近发现不少小伙伴都对文章很感兴趣，所以今天继续给大家介绍文章相关的知识，本文《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 的查询构造能力。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Laravel唯一验证规则使用教程》文章吧，也可关注golang学习网公众号了解相关技术文章。