必须正确配置队列系统以实现异步执行耗时操作;可选 database(轻量)、redis(高性能)、horizon(redis 可视化管理)、supervisor(进程守护)及验证步骤。

如果您在 Laravel 应用中需要将耗时操作(如邮件发送、文件处理、API 调用)从 HTTP 请求中剥离,以提升响应速度并实现异步执行,则必须正确配置队列系统。以下是配置队列任务处理的多种可行方法:
一、切换队列驱动为 database
使用数据库驱动是最轻量且无需额外服务依赖的方案,适用于中小型项目或开发环境。该方式通过 jobs 表暂存任务,由队列工作者轮询读取并执行。
1、在 .env 文件中修改队列连接配置:QUEUE_CONNECTION=database
2、执行 Artisan 命令生成队列表迁移文件:php artisan queue:table
3、执行 Artisan 命令生成失败任务记录表迁移文件:php artisan queue:failed-table
4、运行数据库迁移:php artisan migrate
二、切换队列驱动为 redis
Redis 驱动具备高性能、低延迟和原子出队能力,适合中高并发场景,可避免 database 驱动在高负载下出现的行锁竞争问题。
1、确保已安装并运行 Redis 服务,且 Laravel 项目中已引入 predis 扩展:composer require predis/predis:^1.0
2、在 .env 文件中设置:QUEUE_CONNECTION=redis
3、确认 config/database.php 中 redis.default 配置项可用,且 config/queue.php 中 redis 连接配置的 connection 值与之匹配
4、可选:在 config/queue.php 的 redis 配置块中调整 expire 时间(单位秒),例如设为 'expire' => 3600
三、启用 Horizon 可视化管理(仅限 Redis)
Horizon 提供实时监控、失败重试、吞吐量统计及进程自动伸缩能力,是生产环境推荐的队列管理方案,但仅支持 Redis 驱动。
1、安装 Horizon 包:composer require laravel/horizon
2、发布配置与迁移:php artisan horizon:install
3、运行迁移:php artisan migrate
4、在 config/horizon.php 中配置 worker 数量、超时时间及队列分配策略,例如设置 numprocs=4 表示启动 4 个独立工作进程
5、启动 Horizon 服务:php artisan horizon
四、配置 Supervisor 管理队列工作者进程
Supervisor 可确保 queue:work 进程持续运行、崩溃后自动重启,并支持多进程并发消费,是生产环境稳定运行队列的必备工具。
1、创建 Supervisor 配置文件(如 /etc/supervisor/conf.d/laravel-worker.conf)
2、写入以下内容(路径与参数需按实际项目调整):[program:laravel-worker]
3、设置 process_name、command(含 --queue=default --sleep=3 --tries=3 --timeout=90)、autostart、autorestart、user、numprocs=4 等关键字段
4、重载 Supervisor 配置:sudo supervisorctl reread && sudo supervisorctl update
5、启动所有 worker:sudo supervisorctl start laravel-worker:*
五、验证队列配置是否生效
通过触发一个简易任务并观察其是否被异步执行,可快速验证整个链路是否通畅。此步骤不依赖任何前端界面,纯命令行即可完成。
1、生成测试任务类:php artisan make:job TestQueueJob
2、在 app/Jobs/TestQueueJob.php 的 handle() 方法中添加日志记录:Log::info('TestQueueJob executed at ' . now());
3、在任意控制器方法中分发该任务:$this->dispatch(new TestQueueJob());
4、手动启动监听器(开发环境):php artisan queue:work --tries=1
5、检查 storage/logs/laravel.log 是否出现对应时间戳日志条目











