laravel邮件队列问题需通过supervisor守护解决：一、安装启用supervisor服务；二、为emails队列创建独立配置文件并显式指定--queue=emails；三、执行reread、update、start命令加载启动；四、验证信号广播、日志输出及任务处理；五、调优redis连接数、缓存驱动与优雅退出参数。
如果您在PHP项目中使用Laravel队列发送邮件，但发现邮件任务堆积、延迟或完全不触发，则很可能是queue:work进程未持续运行或未正确加载新代码。以下是解决此问题的步骤：
一、安装并启用Supervisor服务
Supervisor作为进程守护工具，可确保队列worker在系统启动、崩溃或异常退出后自动重启，避免邮件任务因进程终止而停滞。它不依赖shell会话存活，也不受终端关闭影响。
1、在Ubuntu/Debian系统中执行：sudo apt-get install supervisor
2、确认supervisord服务已启用并运行：sudo systemctl enable supervisord && sudo systemctl start supervisord
3、验证服务状态：sudo systemctl status supervisord
4、检查默认配置加载路径是否启用include机制：编辑/etc/supervisor/supervisord.conf，确保包含以下未注释行：[include]\nfiles = /etc/supervisor/conf.d/*.conf
二、创建专用邮件队列Supervisor配置文件
为邮件任务单独定义一个Supervisor程序块，可隔离资源、独立启停、精准日志追踪，并避免与其他队列（如通知、报表）竞争。需显式指定--queue=emails参数，确保仅消费邮件队列。
1、在/etc/supervisor/conf.d/目录下新建文件：sudo nano /etc/supervisor/conf.d/laravel-email-worker.conf
2、写入以下内容（请严格按实际路径、用户、队列名替换）：[program:laravel-email-worker]\nprocess_name=%(program_name)s_%(process_num)02d\ncommand=php /var/www/myapp/artisan queue:work redis --queue=emails --sleep=3 --tries=3 --max-time=3600\nautostart=true\nautorestart=true\nuser=www-data\nnumprocs=2\nredirect_stderr=true\nstdout_logfile=/var/log/laravel-email-worker.log\nstopwaitsecs=3600\nkillasgroup=true\nstopasgroup=true
3、保存后赋予配置文件读取权限：sudo chmod 644 /etc/supervisor/conf.d/laravel-email-worker.conf
三、重载Supervisor配置并启动邮件worker
Supervisor不会自动感知新配置文件，必须通过reread和update命令将其纳入管理范围，再显式启动对应程序组，才能使邮件队列worker真正运行。
1、重新读取所有conf.d下的配置：sudo supervisorctl reread
2、将新配置同步至Supervisor内部状态：sudo supervisorctl update
3、启动邮件专用worker进程组：sudo supervisorctl start laravel-email-worker:*
4、立即检查运行状态：sudo supervisorctl status laravel-email-worker（应显示RUNNING且进程数匹配numprocs）
四、验证邮件队列实际消费能力
仅状态显示RUNNING不代表任务正在执行；必须确认worker已加载最新代码、连接正确队列驱动、且能响应重启信号。关键验证点在于信号广播与进程刷新是否生效。
1、在Laravel Tinker中执行：Cache::get('laravel_queue_restart_signal')，返回非null值表示Redis信号通道可用
2、手动触发一次队列重启：php artisan queue:restart
3、观察日志文件/var/log/laravel-email-worker.log是否出现“Restart signal received”及新进程启动记录
4、分发一条测试邮件任务：Mail::to('test@example.com')->queue(new TestEmail());，检查日志中是否出现“Processing job”及后续执行结果
五、调整Redis连接与内存安全参数
邮件worker高频访问Redis时，若连接数超限或未设置优雅退出窗口，会导致任务中断、连接拒绝或孤儿进程残留，直接影响邮件送达可靠性。
1、检查Redis最大客户端连接数：redis-cli config get maxclients，确保所有numprocs总和不超过该值的80%
2、在config/queue.php中确认'default' => 'redis'且'redis'连接配置中host、port、password与.env一致
3、禁用array缓存驱动：确保CACHE_DRIVER在.env中不为array，否则queue:restart信号无法持久化广播
4、在Supervisor配置中保留stopwaitsecs=3600与killasgroup=true，防止长邮件任务（如附件渲染）被强制终止
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
