Laravel Bootcamp教程中通知发送失败问题求助

问题概述 #

• 跟随Laravel Bootcamp教程进行通知与事件模块开发时，遇到通知无法发送的问题
• .env保留默认邮件配置，使用log驱动，预期邮件内容写入storage/logs/laravel.log
• 执行php artisan queue:work启动队列后，触发Chirp事件但任务1分钟后失败，抛出MaxAttemptsExceededException
• 尝试切换Mailpit、Mailtrap驱动后问题依旧，部分场景下laravel.log无错误记录
• 运行环境：WSL，PHP8.3

排查与解决方案 #

1. 调整队列任务超时与重试配置 #

任务刚好在60秒后失败，优先检查超时相关设置：

• 打开App\Listeners\SendChirpCreatedNotifications类，确认$timeout属性是否合理，可根据实际需求调整：

class SendChirpCreatedNotifications implements ShouldQueue
{
    public $timeout = 30; // 缩短超时时间，避免触发默认60秒限制
    // ...其他代码
}

• 检查config/queue.php中默认队列的retry_after配置，确保其值大于任务的$timeout：

'default' => [
    'driver' => 'database',
    'table' => 'jobs',
    'queue' => 'default',
    'retry_after' => 60, // 需大于任务timeout
],

2. 验证邮件驱动本身是否正常 #

绕过队列，先测试同步发送邮件是否正常：

• 临时注释掉监听器的ShouldQueue接口，让通知同步执行：

// class SendChirpCreatedNotifications implements ShouldQueue
class SendChirpCreatedNotifications
{
    // ...其他代码
}

• 发送一条Chirp，查看storage/logs/laravel.log是否生成邮件内容。若同步正常，说明问题出在队列环节；若同步也失败，检查通知类代码是否存在错误。

3. 修复WSL环境下的权限与进程问题 #

WSL环境易出现资源限制或权限异常：

• 确保storage/目录有正确读写权限：

chmod -R 775 storage/
chown -R $USER:$USER storage/ # 替换为你的WSL用户名

• 手动指定超时时间启动队列，避免默认超时触发：

php artisan queue:work --timeout=30

• 尝试用queue:listen替代queue:work测试，避免进程被WSL自动回收：

php artisan queue:listen --timeout=30

4. 检查通知类代码逻辑 #

若同步发送也失败，排查通知类的正确性：

• 打开App\Notifications\ChirpCreated，确保toMail方法返回合法的MailMessage实例，无语法或逻辑错误：

public function toMail($notifiable)
{
    return (new MailMessage)
                ->line('新的Chirp已发布！')
                ->action('查看Chirp', url('/chirps/'.$this->chirp->id))
                ->line('感谢使用我们的应用！');
}

• 确认通知类中正确传递了chirp实例，无空值或未定义属性。

5. 清空堆积的失败队列 #

若之前的失败任务堆积，可能影响新任务执行：

php artisan queue:flush
php artisan queue:clear

重新启动队列后发送Chirp测试。

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