Laravel 邮件通知跳过失败用户方法

本文介绍在 Laravel 中使用 `foreach` 批量触发邮件通知时，如何通过异常捕获机制避免单个邮件发送失败导致整个循环中断，确保任务持续执行。

在 Laravel 应用中，当需要向多个用户批量发送欢迎邮件（如 MailBienvenida 通知）时，若某位用户的邮箱格式错误、SMTP 连接超时、收件人地址被拒或邮件服务临时不可用，Laravel 默认会抛出 Throwable（包括 Exception 和 PHP 7+ 的 Error），导致 foreach 循环立即终止——这显然不符合“尽最大努力送达”的业务需求。

解决的核心思路是：将每个通知的触发逻辑包裹在 try-catch 块中，并统一捕获 Throwable（而非仅 Exception），从而保证单点失败不影响整体流程。

✅ 正确做法：使用 Throwable 全局捕获

use Throwable;

$users = User::where('status', 'pending')->get();

foreach ($users as $user) {
    try {
        $user->notify(new MailBienvenida($user->name, $user->activation_code));
        \Log::info("Email sent successfully to {$user->email}");
    } catch (Throwable $e) {
        // 记录具体错误，便于后续排查（如无效邮箱、DNS 失败、认证拒绝等）
        \Log::error("Failed to send welcome email to {$user->email}: " . $e->getMessage(), [
            'exception' => get_class($e),
            'trace'     => $e->getTraceAsString(),
        ]);
        // continue 自动生效，无需显式写；此处仅作语义强调
        continue;
    }
}

⚠️ 注意事项与最佳实践

• 必须捕获 Throwable：PHP 7+ 中部分致命错误（如 TypeError、ParseError）不继承 Exception，但均实现 Throwable 接口。仅 catch (Exception $e) 无法捕获它们。
• 日志至关重要：跳过错误不等于忽略问题。务必记录失败邮箱、异常类型和消息，建议使用结构化日志（如 Monolog 的 context 参数）。
• 避免静默失败：切勿留空 catch 块。至少记录错误，否则调试将极其困难。
• 考虑队列优化：若用户量大，应将通知分发至队列（implements ShouldQueue + dispatch()），并在队列任务中做同样异常防护，而非在同步循环中阻塞执行。
• 补充验证前置检查：可在循环前过滤明显无效邮箱（如 filter_var($email, FILTER_VALIDATE_EMAIL) === false），减少不必要的 SMTP 调用。

? 总结

通过 try-catch (Throwable) 包裹单次通知触发，你就能构建出具备容错能力的批量邮件系统：一个用户的失败不会波及其他用户，系统保持健壮性与可观测性。这是生产环境处理异步通信任务（邮件、短信、Webhook）的通用范式——失败可接受，中断不可取。