Laravel 5.x表单提交重复唯一字段触发SQL约束错误求助

这个问题我之前也碰到过，本质是你跳过了Laravel表单验证环节的唯一字段校验，直接把数据提交到数据库，触发了数据库层的唯一约束，而没有让Laravel在应用层提前拦截错误、友好返回表单页面并保留用户输入。

核心思路 #

在数据存入数据库之前，通过Laravel的验证机制检查唯一字段是否已存在，这样就能在应用层拦截重复数据，自动重定向回表单页面，同时保留用户已填内容并显示错误提示，而不是直接抛出SQL异常。

具体解决方案 #

1. 在控制器中添加验证规则（快速实现） #

如果你是直接在控制器里处理表单提交，可以使用Laravel提供的validate方法，给唯一字段加上unique规则：

use Illuminate\Http\Request;
use App\Models\YourModel; // 替换成你的模型类

public function store(Request $request)
{
    // 验证请求数据，替换成你的表名和字段名
    $validatedData = $request->validate([
        'name' => 'required|string|max:255',
        'your_unique_field' => 'required|unique:your_table_name', // 关键：unique规则，格式为unique:表名,字段名（字段名可省略，默认用表单字段名）
        // 其他表单字段的验证规则
    ]);

    // 验证通过后，再执行数据库保存操作
    YourModel::create($validatedData);

    return redirect()->back()->with('success', '数据保存成功！');
}

2. 使用Form Request类（更规范的方式） #

如果你的表单逻辑比较复杂，推荐创建专门的Form Request类来管理验证规则：

1. 生成请求类：

php artisan make:request StoreYourModelRequest

2. 在生成的app/Http/Requests/StoreYourModelRequest.php中定义规则和授权逻辑：

public function authorize()
{
    return true; // 允许所有用户提交这个请求，根据你的需求调整
}

public function rules()
{
    return [
        'name' => 'required|string|max:255',
        'your_unique_field' => 'required|unique:your_table_name',
        // 其他字段规则
    ];
}

// 可选：自定义错误提示信息
public function messages()
{
    return [
        'your_unique_field.unique' => '这个值已经存在，请更换其他内容！',
    ];
}

3. 在控制器中使用这个请求类：

use App\Http\Requests\StoreYourModelRequest;
use App\Models\YourModel;

public function store(StoreYourModelRequest $request)
{
    // 验证已经自动完成，直接保存数据
    YourModel::create($request->validated());

    return redirect()->back()->with('success', '数据保存成功！');
}

3. 在视图中显示错误提示 #

Laravel会自动把验证错误信息传到视图，你只需要在表单字段旁添加错误提示代码即可，同时用old()方法保留用户之前输入的内容：

<div class="form-group">
    <label for="your_unique_field">唯一字段</label>
    <input 
        type="text" 
        name="your_unique_field" 
        id="your_unique_field" 
        value="{{ old('your_unique_field') }}" 
        class="form-control @error('your_unique_field') is-invalid @enderror"
    >
    {{-- 显示错误提示 --}}
    @error('your_unique_field')
        <span class="invalid-feedback" role="alert">
            <strong>{{ $message }}</strong>
        </span>
    @enderror
</div>

为什么之前会抛出SQL错误？ #

当你没有在应用层做验证时，Laravel会直接执行数据库插入操作，此时数据库发现违反唯一约束，就会抛出SQLSTATE[23000]的异常。而Laravel的验证机制会自动处理验证失败的情况：重定向回表单页面、保留用户输入、传递错误消息，这才是符合用户体验的正确流程。

内容的提问来源于stack exchange，提问作者Tadej Bogataj