如何在Laravel验证器中捕获邮箱已存在的验证失败事件

我设置了一个Laravel验证器，包含以下规则：

• 校验邮箱格式是否正确
• 校验邮箱是否已存在于数据库中
• 其他字段校验（可忽略）

验证器代码如下：

$validator = Validator::make($request->all(), [
    'name' => 'required|string|max:255',
    'email' => 'required|string|email|max:255|unique:MyTable,email',
    'mobile' => ['required', 'regex:/^(62)8[1-9][0-9]{6,9}$/'], // Valid: 6281234567890
    'birthdate' => 'required|date',
    'password' => ['required', 'confirmed', Password::min(8)->mixedCase()->numbers()],
    'allow_received_information' => 'integer',
]);

当前表单输入有误时，会通过以下代码逐个显示错误信息：

if ($validator->stopOnFirstFailure()->fails()) {
    return ResponseFormatter::error(null, implode(",", $validator->messages()->all()));
}

问题 #

我需要在众多验证规则中，单独捕获「邮箱已存在于数据库」的验证失败事件，期望实现类似如下逻辑：

if ('email' == alreadyExistFunc()) {
    # 邮箱已存在逻辑
} else {
    # 邮箱不存在逻辑
}

尝试方案1 #

我了解到Laravel的After Validation Hook功能，但不确定是否适用及具体用法，示例代码如下：

$validator = Validator::make();
 
$validator->after(function ($validator) {
    if ($this->somethingElseIsInvalid()) {
        $validator->errors()->add(
            'field', 'Something is wrong with this field!'
        );
    }
});
 
if ($validator->fails()) {
    //
}

尝试方案2 #

我可以移除验证规则中的邮箱unique校验，手动查询数据库判断邮箱是否存在，代码如下：

$isExist = MyTable::where('email', $request->email)->first();

if ($isExist != null) {
    # 对应逻辑
} else {
    # 对应逻辑
}

但不确定这是否为最佳实践，我认为应该有更自动化的实现方式，希望得到相关建议或解决方案。

推荐解决方案 #

不需要移除原有验证规则，也无需额外自定义Hook，直接利用Laravel验证器返回的错误集合即可精准判断场景，这也是最符合框架最佳实践的方式：

方式一：直接判断错误文本（简单直观） #

Laravel的unique规则验证失败时，会生成固定的错误提示（中文环境下默认是该邮箱已被注册），你可以直接检查email字段的错误是否包含该内容：

if ($validator->stopOnFirstFailure()->fails()) {
    // 检查email字段是否存在重复注册的错误
    if ($validator->errors()->has('email')) {
        $emailError = $validator->errors()->first('email');
        if ($emailError === '该邮箱已被注册') {
            // 执行邮箱已存在的专属逻辑
            return ResponseFormatter::error(null, '该邮箱已被注册，请更换邮箱重试');
        }
    }
    // 其他验证错误的通用处理
    return ResponseFormatter::error(null, implode(",", $validator->messages()->all()));
}

方式二：通过验证规则键判断（多语言友好） #

如果你的项目支持多语言，硬编码错误文本会有兼容性问题，此时可以通过对比翻译文件中的unique规则提示来判断，避免文本依赖：

if ($validator->stopOnFirstFailure()->fails()) {
    if ($validator->errors()->has('email')) {
        $translator = $validator->getTranslator();
        // 生成unique规则对应的错误提示
        $expectedError = $translator->trans('validation.unique', [
            'attribute' => $translator->trans('validation.attributes.email'),
            'table' => strtolower('MyTable')
        ]);
        
        if ($validator->errors()->first('email') === $expectedError) {
            // 邮箱已存在逻辑
            return ResponseFormatter::error(null, $expectedError);
        }
    }
    // 其他错误处理
    return ResponseFormatter::error(null, implode(",", $validator->messages()->all()));
}

关于尝试方案的补充说明 #

• 尝试方案1（After Hook）：其实可以用，但没必要——因为unique规则已经帮你完成了数据库查询和错误判断，Hook方式相当于重复实现相同逻辑，反而冗余。
• 尝试方案2（手动查询）：虽然可行，但会失去Laravel验证器的自动错误收集、多语言支持等特性，同时还要自己处理输入合法性前置校验（比如邮箱格式是否正确），不如直接用框架自带规则高效。

综上，保留原有unique验证规则，再通过错误集合判断场景的方式，是最简洁、高效且符合Laravel设计理念的实现。

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