使用Laravel向多个收件人发邮件时循环发送仅成功1封如何解决

常见触发原因 #

• 旧版本Laravel的Mail门面底层消息实例复用：默认每次调用to()方法是追加收件人而非覆盖，导致所有收件人被添加到同一封邮件中，最终仅发送1次
• 查询条件有误：User查询结果实际仅返回1条符合条件的用户数据，导致循环只执行1次
• 循环过程中抛出异常：后续收件人数据存在邮箱为空、格式非法等问题，触发异常后终止了整个循环的执行
• 邮件服务速率限制：Gmail等免费邮件服务商有严格的发信频率限制，触发限制后后续发信请求会被直接拦截
• 队列未正常消费：如果开启了邮件队列配置但队列进程未启动，仅第一封邮件被同步发送，其余邮件滞留在队列中未处理

修复方案 #

1. 优化发信逻辑，避免实例复用 #

推荐直接遍历User查询集合，每次发信前清空残留收件人，代码如下：

// 先过滤掉无有效邮箱的用户，确认查询结果数量符合预期
$users = User::select('name','staffid','email')
    ->whereNotNull('email')
    ->where('email', '!=', '')
    ->get();

// 打印确认收件人数量，可根据实际情况删除
// dd($users->count());

foreach ($users as $user) {
    Mail::send('email.sendReminder', ["data1" => $user], function($message) use ($user) {
        // 清空之前残留的收件人，避免实例复用问题
        $message->setTo([]);
        $message->from('test@gmail.com', 'Test Reminder');
        $message->to($user->email);
        $message->subject('Reminder');
    });

    // 可选：增加1秒间隔，避免触发邮件服务速率限制
    sleep(1);
}

如果是Laravel 5.5及以上版本，建议使用Mailable类发送，天然避免实例复用问题。

2. 排查异常与执行日志 #

打开storage/logs/laravel.log查看循环过程中是否有报错，也可以在循环中增加日志记录确认每一步都执行：

foreach ($users as $user) {
    info("开始发送邮件至：{$user->email}");
    // 发信逻辑
    if (!empty(Mail::failures())) {
        info("发送至{$user->email}失败，失败地址：" . json_encode(Mail::failures()));
    } else {
        info("发送至{$user->email}成功");
    }
}

3. 适配邮件服务规则 #

如果使用第三方邮件服务，先核对服务商的发信速率限制，调整循环间隔，避免触发限流规则。

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