在 laravel 中，可通过 `rule::unique()` 结合 `where()` 方法，为字段（如身份证号）设置带附加条件的唯一性校验，例如仅当用户角色为 2 时才要求该证件号全局唯一。
在实际业务中，常需对“唯一性”施加上下文约束——比如仅在特定角色（如 rol_usu = 2）下确保 document_usu（用户证件号）不重复，而其他角色可复用相同证件号。此时，原生的 unique:users,document_usu 规则无法满足需求，因为它会全局检查整个表。
Laravel 提供了灵活的 Illuminate\Validation\Rule 类来解决这一问题。正确做法是使用 Rule::unique('table', 'column') 并链式调用 where() 方法，动态添加 SQL WHERE 条件：
use Illuminate\Validation\Rule;
$request->validate([
'document_usu' => [
'required',
Rule::unique('users', 'document_usu')->where(function ($query) use ($request) {
return $query->where('rol_usu', 2);
}),
],
]);⚠️ 注意事项：
- use ($request) 是必需的，用于将当前请求实例传入闭包，以便在复杂场景中读取动态值（如 $request->input('rol_usu')）；
- 若需多条件（如 rol_usu = 2 AND status = 'active'），可在 where() 内继续链式调用：->where('status', 'active')；
- 该规则仅作用于创建场景；更新时需排除自身记录，避免误判，推荐写法：
Rule::unique('users', 'document_usu') ->where(fn ($q) => $q->where('rol_usu', 2)) ->ignore($request->id, 'id') // 假设主键为 id
✅ 总结：Rule::unique() + where() 是 Laravel 实现“条件唯一性验证”的标准、安全且可读性强的方式，既避免了手写 SQL 或自定义验证器的复杂度，又完全兼容 Laravel 的验证生命周期与错误提示机制。
