Laravel怎么实现模型唯一性验证_Laravel联合字段唯一约束【操作】-Laravel-PHP中文网

laravel 的 rule::unique() 不支持直接逗号分隔联合字段，须用 where() 添加条件；编辑时需 ignore() 排除自身 id；数据库必须建联合唯一索引以防止并发冲突。

laravel怎么实现模型唯一性验证_laravel联合字段唯一约束【操作】

unique 规则不支持联合字段？用 Rule::unique() 配合 where()

直接在 unique 规则里写两个字段（比如 "email,company_id"）会报错或失效——Laravel 的原生 unique 验证器只认单字段名，逗号分隔的写法是旧版遗留语法，5.8+ 已弃用且不生效。

正确做法是用 Rule::unique() 构造器，配合 where() 添加额外条件：

use Illuminate\Validation\Rule;

Validator::make($data, [
    'email' => [
        'required',
        Rule::unique('users')->where(fn ($query) => $query->where('company_id', $data['company_id'])),
    ],
]);

必须用 Rule::unique('表名')，不能只写 'unique:users'，否则 where() 无法链式调用
$data['company_id'] 要确保已存在且非空，否则 where() 会生成 WHERE company_id = NULL，查不到数据导致误通过
如果 company_id 来自请求以外（比如当前用户所属公司），应从上下文取值，而非依赖 $data

更新时排除自身 ID：忽略当前模型记录

编辑已有记录时，如果不排除自己，验证会因“当前邮箱已被自己占用”而失败。这是最常被跳过的一步。

Rule::unique() 提供 ignore() 方法，但要注意参数顺序和类型：

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

Rule::unique('users')
    ->where(fn ($query) => $query->where('company_id', $company_id))
    ->ignore($user->id)

ignore() 第一个参数是主键值（如 123），不是模型实例；传 $user 会触发隐式转换，可能出错
如果主键不是 id（比如叫 uuid），必须显式指定字段名：->ignore($user->uuid, 'uuid')
在表单提交中，$user->id 必须来自数据库真实记录，不能是前端传来的伪造 ID

数据库层面加联合唯一索引，不是可选项

只靠 PHP 层验证，高并发下仍可能插入重复数据。比如两个请求几乎同时通过验证，再先后执行 INSERT，就会突破唯一性。

必须在迁移中添加数据库约束：

Schema::table('users', function (Blueprint $table) {
    $table->unique(['email', 'company_id']);
});

索引名建议显式指定，避免 Laravel 自动生成难以识别的长名：->unique(['email', 'company_id'], 'users_email_company_unique')
如果表已有数据，加索引前先清理重复项，否则迁移会失败
MySQL 中该索引允许多行 NULL 值（即 company_id 为 NULL 时不受限），若业务不允许，需额外用 CHECK 约束或应用层拦截