Laravel队列怎么用_Laravel异步任务处理配置指南【教程】-Laravel-PHP中文网

生产首选 redis，因其速度快、支持延迟队列和自动重试；开发期可用 database 省事，但高并发下易受数据库锁和连接数限制；需避免 sync 驱动误用、确保 worker 进程运行、正确传递数据、合理配置重试机制。

laravel队列怎么用_laravel异步任务处理配置指南【教程】

队列驱动选 `database` 还是 `redis`？

database 最省事，开发期直接用，不用装额外服务；但并发高时会卡在数据库锁和连接数上，尤其用 MySQL 的 SELECT FOR UPDATE 做任务抢占，容易堆积。
redis 是生产首选，速度快、支持延迟队列、能自动重试，但得确保 Redis 持久化配置合理（比如关掉 save 或用 AOF），否则断电可能丢任务。

本地调试：直接改 .env 为 QUEUE_CONNECTION=database，跑 php artisan queue:table + migrate
生产上线：QUEUE_CONNECTION=redis，确认 config/database.php 里 redis 配置指向正确实例
别把 sync 当真队列用——它只是同步执行，dispatch() 看似进了队列，实则立刻跑，测逻辑可以，压测或真实异步场景会翻车

`dispatch()` 后任务没执行？先看这三件事

Laravel 不会自动轮询队列，必须手动启监听进程。常见现象是调了 dispatch()，日志没输出、数据库 jobs 表有记录但一直不消费。

检查是否运行了 php artisan queue:work（单次）或 php artisan queue:listen（旧版，已弃用）
确认 QUEUE_CONNECTION 和实际运行的 worker 一致，比如 .env 是 redis，但手误敲成 php artisan queue:work --connection=database
查 storage/logs/laravel.log，重点搜 Failed to process job 或 Connection refused —— 很可能是 Redis 连不上，或任务类没加 implements ShouldQueue

任务类里不能直接用 `$request` 或 `session()`

HTTP 请求生命周期一结束，$request、session()、auth() 全失效。队列任务是独立进程启动的，没上下文。

Laravel 13.2.0

PHP中文网提供Laravel 13.2.0版本下载，Laravel框架是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。

下载

只传必要数据：比如 User::find(123) 改成传 123，进任务里再查
别在构造函数里做查询或写日志，构造函数在分发时就执行了（不是消费时）
想记录用户行为？把 auth()->id() 提前取出来，作为参数传进 dispatch()，别指望进任务还能调 auth()

重试机制怎么设才不爆库？

tries 和 backoff 控制失败后重试次数和间隔，设太激进会导致任务反复刷库、拖慢整个队列。

默认 tries = 1，意味着失败一次就进 failed_jobs 表，适合强一致性操作（比如扣库存）
异步通知类任务可设 tries = 3，配合 public $backoff = 60;（秒），避免瞬间重试压垮第三方 API
别全局改 config/queue.php 的 retry_after，它控制的是「一个任务最长处理时间」，超时会被释放回队列——MySQL 驱动下这个值必须小于 wait_timeout，否则连接断开报错

队列不是万能胶，任务体要足够轻，依赖要显式传递，失败路径比成功路径更值得花时间想清楚。