已配置SQS的Laravel任务未触发，邮件发送事件调用后无法发信

1. 队列配置类问题 #

• 确认队列驱动配置生效：检查.env文件中QUEUE_CONNECTION参数值为sqs，没有被config/queue.php的硬编码配置覆盖，也没有在业务代码中临时指定了其他队列驱动
• 确认SQS队列消费进程已启动：事件被触发仅代表任务成功推送到SQS队列，必须启动队列消费者才能实际执行邮件发送逻辑，本地测试可执行命令php artisan queue:work sqs启动消费进程，生产环境建议用supervisor托管进程避免意外中断
• 检查SQS权限与配置正确性：确认AWS密钥对应账号拥有sqs:ReceiveMessage、sqs:DeleteMessage、sqs:GetQueueAttributes等必要操作权限，同时.env中AWS_DEFAULT_REGION参数要和SQS队列实际所在区域一致，否则会出现任务无法消费的情况
• 检查队列任务状态：如果任务执行出错达到重试上限，会被移入失败队列，可执行php artisan queue:failed查看是否存在对应的失败邮件任务；如果任务分发时设置了delay()，会到指定时间才会被消费，不会立即触发发送

2. 邮件配置类问题 #

• 确认邮件驱动配置正确：检查.env中MAIL_MAILER对应参数（SMTP的host、端口、账号密码，或SES、mailgun等第三方服务配置）是否正确，可先将MAIL_MAILER临时改为log，测试邮件内容是否会写入storage/logs/laravel.log，排除邮件服务本身的配置问题
• 检查是否存在发送拦截逻辑：如果邮件类、事件监听器中存在条件判断跳过发送的逻辑（比如非生产环境屏蔽发送、对特定收件地址拦截发送等），会出现事件触发但实际不执行发送的情况
• 确认未开启邮件伪造：测试环境下如果代码中调用了Mail::fake()，会拦截所有真实邮件发送请求，仅记录发送日志不会实际投递

3. 事件绑定类问题 #

• 确认事件与监听器绑定正确：检查app/Providers/EventServiceProvider.php中的$listen数组，邮件发送事件对应的监听器是否正确绑定，没有关联到错误的处理类
• 确认监听器未终止事件传播：如果监听器处理逻辑最后返回false，会终止事件的后续传播，导致后续的发送逻辑被中断

内容的提问来源于stack exchange，提问作者Орлов Владлен