laravel 中使用定时任务每日发送邮件时，若邮件未送达，很可能是因 `mailable` 类启用了 `queueable` 但未运行队列进程所致；本文详解如何正确配置队列驱动、启动队列监听器，并验证邮件发送流程。
在 Laravel 中，通过 Artisan 命令 + Scheduler 实现每日邮件推送是常见做法，但一个关键陷阱常被忽略：只要 Mailable 类使用了 use Queueable（如你的 NotifyEmail），该邮件默认进入队列异步发送，而非立即执行。这意味着即使 schedule:run 成功触发命令，若没有主动消费队列，邮件将永远“挂起”——既不发送，也不报错。
✅ 正确配置步骤
1. 确认队列驱动已启用
在 .env 文件中，确保使用支持的队列驱动（推荐 database 或 redis）：
QUEUE_CONNECTION=database
然后运行迁移以创建队列数据表：
php artisan queue:table php artisan migrate
2. 移除冗余队列逻辑（可选但推荐）
如果你的邮件逻辑简单、用户量不大，且无需异步解耦，可直接禁用队列，让邮件同步发送：
修改 NotifyEmail.php，移除 Queueable 和 SerializesModels：
<?php
namespace App\Mail;
use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
// use Illuminate\Queue\SerializesModels; ← 删除此行
class NotifyEmail extends Mailable
{
// use Queueable, SerializesModels; ← 全部删除
public $details;
public function __construct($data)
{
$this->details = $data;
}
public function build()
{
return $this->view('mail')->with('details', $this->details); // 修复 compact() 语法错误
}
}⚠️ 注意：原代码中 compact(varname: 'details') 是无效 PHP 语法，应改为 compact('details') 或更清晰的 with('details', $this->details)。
3. 若坚持使用队列，请务必运行队列监听器
在生产环境，需常驻进程消费队列。启动方式如下：
# 开发环境测试（前台运行，便于观察日志） php artisan queue:work # 生产环境推荐（后台守护进程） php artisan queue:work --daemon --sleep=3 --max-jobs=1000
? 提示：配合 Supervisor 管理进程，避免中断（详见 Laravel 队列文档）。
4. 验证邮件配置与权限
确保 .env 中 SMTP 设置正确（尤其 MAIL_MAILER, MAIL_HOST, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD），并测试基础发送：
php artisan tinker
>>> Mail::to('test@example.com')->send(new App\Mail\NotifyEmail(['title' => 'Test', 'body' => 'OK']));? 总结与最佳实践
- 默认队列行为是“静默失败”的根源：Queueable ≠ 自动执行，必须有 queue:work 进程；
- 同步发送适合低频、小批量通知（如每日提醒），异步队列适合高并发或耗时操作；
- 始终检查 Blade 视图变量传递方式（with() 比 compact() 更安全可控）；
- 在 handle() 方法中添加日志，确认命令是否真正执行：
\Log::info('notify:email command executed', ['count' => count($emails)]);
完成上述配置后，再执行 php artisan schedule:run 并检查日志或邮箱收件箱，邮件即可稳定送达。
