Laravel发送验证邮件遇SMTP 550错误，如何处理并提示用户？

问题场景 #

用户完成注册流程后，系统发送账号确认邮件时，SMTP服务器返回550（无效邮箱）错误，而非预期的250响应码，同时Web服务器抛出500内部服务器错误。需要捕获该错误并向用户友好提示「邮箱不存在」。

环境配置（.env文件） #

MAIL_MAILER=smtp
MAIL_DRIVER=smtp
MAIL_HOST=smtp.dmd120.com
MAIL_PORT=465
MAIL_USERNAME=noreply@dmd120.com
MAIL_PASSWORD=pass
MAIL_ENCRYPTION=ssl
MAIL_FROM_ADDRESS=noreply@dmd120.com
MAIL_FROM_NAME="${APP_NAME}"

解决方案 #

1. 捕获SMTP发送异常 #

Laravel在邮件发送失败时会抛出特定异常，需在注册逻辑中通过try-catch捕获并判断错误类型，返回友好提示：

Laravel 8及以下版本

// 注册控制器的store方法示例
public function store(Request $request)
{
    // 验证注册数据
    $validated = $request->validate([
        'name' => 'required|string|max:255',
        'email' => 'required|string|email|max:255|unique:users',
        'password' => 'required|string|min:8|confirmed',
    ]);

    // 创建用户
    $user = User::create($validated);

    // 尝试发送确认邮件
    try {
        Mail::to($user->email)->send(new VerifyEmail($user));
    } catch (\Swift_TransportException $e) {
        // 判断是否为无效邮箱错误
        if (str_contains($e->getMessage(), '550')) {
            // 删除已创建的用户（可选，根据业务需求）
            $user->delete();
            return back()->withErrors(['email' => '该邮箱不存在，请检查后重新输入']);
        }
        // 处理其他SMTP异常
        return back()->withErrors(['email' => '邮件发送失败，请稍后重试']);
    }

    return redirect()->route('login')->with('success', '注册成功，请查收邮件完成验证');
}

Laravel 9及以上版本

Laravel 9+使用Symfony Mailer组件，异常类有所不同：

// 注册控制器的store方法示例
public function store(Request $request)
{
    $validated = $request->validate([
        'name' => 'required|string|max:255',
        'email' => 'required|string|email|max:255|unique:users',
        'password' => 'required|string|min:8|confirmed',
    ]);

    $user = User::create($validated);

    try {
        Mail::to($user->email)->send(new VerifyEmail($user));
    } catch (\Symfony\Component\Mailer\Exception\TransportExceptionInterface $e) {
        if (str_contains($e->getMessage(), '550')) {
            $user->delete();
            return back()->withErrors(['email' => '该邮箱不存在，请检查后重新输入']);
        }
        return back()->withErrors(['email' => '邮件发送失败，请稍后重试']);
    }

    return redirect()->route('login')->with('success', '注册成功，请查收邮件完成验证');
}

2. 生产环境配置优化 #

• 确保.env中APP_DEBUG=false，避免将服务器错误详情暴露给用户。
• 自定义500错误页面（可选）：在resources/views/errors/500.blade.php创建自定义页面，统一服务器错误的展示样式。

3. 可选：提前邮箱有效性校验 #

若想在注册前提前拦截无效邮箱，可通过以下方式：

• 前端：添加邮箱格式校验，确保输入符合邮箱规范。
• 后端：通过DNS MX记录查询邮箱域名是否存在邮件服务器，但SMTP返回的550错误是最权威的有效性验证结果。

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