Laravel项目邮箱唯一校验无法显示自定义报错提示如何解决？

问题核心原因 #

你当前碰到的是数据库层面抛出的唯一约束异常，没有在应用层做提前校验，所以直接触发了Laravel的系统错误页，没有走到视图错误提示的逻辑。按以下步骤处理即可：

步骤1：在提交数据的逻辑中添加表单验证 #

这是最常用的拦截方式，在UserController的store方法开头添加验证规则，提前校验邮箱唯一性：

public function store(Request $request)
{
    // 新增验证逻辑，支持自定义错误消息
    $validated = $request->validate([
        'name' => 'required|string|max:255',
        'firstname' => 'required|string|max:255',
        'lastname' => 'required|string|max:255',
        'email' => 'required|email|unique:users,email',
    ], [
        'email.unique' => '该邮箱已经被注册，请更换其他邮箱',
        // 其他字段的自定义错误也可以在这里补充
    ]);

    // 后面是你原有创建用户的逻辑，示例：
    User::create($validated + ['password' => bcrypt('你的密码生成逻辑')]);

    return redirect()->route('users.index')->with('success', '用户创建成功');
}

这里的validate方法校验失败时会自动重定向回表单页，并且把错误信息写入session，你视图里写的$errors遍历逻辑就能正常读到错误提示

步骤2：兜底捕获数据库异常（可选，适合高并发场景） #

如果怕极端并发场景下，验证和写入的间隙有其他请求写入了相同邮箱，还可以用try-catch捕获数据库的唯一约束异常，避免系统报错：

use Illuminate\Database\QueryException;

public function store(Request $request)
{
    $validated = $request->validate([
        // 同上的验证规则
    ]);

    try {
        User::create($validated + ['password' => bcrypt('你的密码生成逻辑')]);
    } catch (QueryException $e) {
        // 判断是否是唯一约束错误，MySQL唯一约束错误码为1062
        if ($e->errorInfo[1] == 1062 && str_contains($e->getMessage(), 'users_email_unique')) {
            return redirect()->back()->withInput()->withErrors(['email' => '该邮箱已经被注册，请更换其他邮箱']);
        }
        // 其他数据库错误可以按需求处理
        throw $e;
    }

    return redirect()->route('users.index')->with('success', '用户创建成功');
}

步骤3：确认路由配置 #

确保你的users.store路由是在web中间件组下的，web中间件会自动开启session、共享$errors变量到视图，否则$errors变量会不存在，错误也无法显示：

// routes/web.php
Route::middleware('web')->group(function () {
    // 你的用户相关路由放在这里
    Route::resource('users', UserController::class);
});

可选优化：单独显示邮箱错误 #

你可以在表单的邮箱输入框下方单独显示邮箱相关的错误，提示更精准：

<input type="text" class="form-control" id="email" name="email" required>
@error('email')
    <span class="text-danger">{{ $message }}</span>
@enderror

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