如何在Laravel中为数据表多列设置联合唯一约束？

要确保column1和column2的组合值唯一，最佳实践是同时在数据库层面和应用层面做处理，既保证数据的一致性，又给用户友好的反馈。

1. 数据库层面：添加联合唯一索引 #

这是最核心的保障，直接在迁移文件中给两列添加联合唯一约束，即使绕过应用代码直接操作数据库，也能阻止重复数据插入。

修改你的迁移文件：

Schema::create('my_table', function (Blueprint $table) {
    $table->id();
    $table->string('column1');
    $table->string('column2');
    // ... 其他列 ...
    $table->timestamps();
    
    // 添加联合唯一约束
    $table->unique(['column1', 'column2']);
});

如果表已经创建好，需要新增约束，可以创建一个新的迁移文件：

Schema::table('my_table', function (Blueprint $table) {
    $table->unique(['column1', 'column2']);
});

2. 应用层面：添加验证规则 #

数据库约束触发时会抛出SQL异常，为了给用户更友好的提示，需要在模型或请求验证类中添加联合唯一的验证规则。

在请求验证类中添加规则 #

比如创建一个StoreMyTableRequest，规则如下：

public function rules()
{
    return [
        'column1' => 'required|string',
        'column2' => 'required|string|unique:my_table,column2,NULL,id,column1,' . $this->column1,
    ];
}

在模型的验证规则中添加（如果使用模型验证） #

public static function rules($id = null)
{
    return [
        'column1' => 'required|string',
        'column2' => [
            'required',
            'string',
            Rule::unique('my_table')->where(function ($query) use ($id) {
                $query->where('column1', request()->column1);
            })->ignore($id),
        ],
    ];
}

这个规则的作用是：创建时检查column1+column2是否重复；更新时忽略当前记录的约束，避免自己和自己重复。

3. 处理数据库异常（可选） #

如果没有在应用层做验证，或者有特殊场景绕过了验证，数据库会抛出QueryException，可以在控制器中捕获并处理：

try {
    // 保存或更新数据的逻辑
} catch (\Illuminate\Database\QueryException $e) {
    // 检查是否是唯一约束违反的错误码（不同数据库错误码不同，比如MySQL是1062）
    if ($e->getCode() == 1062) {
        return back()->withErrors(['error' => 'column1和column2的组合值已存在']);
    }
    throw $e;
}

内容的提问来源于stack exchange，提问作者PHP LARAVEL