跳转到主内容
趣航编程网 - 趣学编程,启航技术之路!

Laravel队列驱动怎么选_Laravel队列配置方法【详解】

QUEUE_CONNECTION改了仍同步执行,根本原因是配置未刷新:必须运行php artisan config:clear(开发)或config:cache(生产),否则Laravel读取缓存旧配置,默认sync;验证用tinker执行config('queue.default')应返回redis等非sync值。 QUEUE_CONNECTION 改了但任务还是同步执行 这是最常踩的坑:改完
.env
里的
QUEUE_CONNECTION=redis
,
php artisan queue:work
却依然立刻执行任务,毫无异步感。 根本原因不是驱动没配对,而是 Laravel 没读到新配置——它默认读的是缓存后的 config,不是实时解析的
.env
。 开发环境必须运行
php artisan config:clear
,否则永远走旧缓存里的
sync
生产环境要用
php artisan config:cache
(注意:改完
.env
后再跑) 验证是否生效:进
php artisan tinker
,执行
config('queue.default')
,返回值必须是你设的驱动名,比如
"redis"
,不是
"sync"
别混淆
QUEUE_DRIVER
(Laravel 5.7 以前)和
QUEUE_CONNECTION
(5.7+),新版只认后者 database 驱动报 “Base table or view not found: 1146 Table 'xxx.jobs'” 这不是配置错,是表压根没建。database 驱动依赖三张表:
jobs
、
failed_jobs
、
job_batches
(Laravel 9+ 才有),缺一不可。 先执行
php artisan queue:table
生成
jobs
表迁移 再执行
php artisan queue:failed-table
和
php artisan queue:batches-table
(如果项目用了批量任务) 最后统一运行
php artisan migrate
;已上线项目慎用
migrate:fresh
,可用
php artisan migrate --path=database/migrations/2026_01_01_000000_create_jobs_table.php
单独跑 确认
config/queue.php
中
connections.database.table
值是
'jobs'
(默认值),别手误改成别的表名 redis 驱动连不上,
queue:work
一直 idle Redis 连接失败时,Laravel 不报错,只默默跳过——你看到的 “idle” 很可能就是连接被拒绝后静默退出的表现。 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 开发首选,它兼顾安全与极速体验,助您快速构建企业级应用。 下载 检查
REDIS_HOST
和
REDIS_PORT
:Docker 环境下
localhost
指宿主机,得填容器名如
redis
QUEUE_CONNECTION=redis
时,Laravel 只读
REDIS_*
系列变量(
REDIS_HOST
、
REDIS_PASSWORD
等),不看
QUEUE_HOST
这类命名 Redis 有密码?必须设
REDIS_PASSWORD
,且 Laravel 7+ 要求
REDIS_URL
格式为
redis://:password@host:port
,否则连接被拒也不提示 验证连接最直接:进
tinker
,执行
Redis::ping()
,能回
"PONG"
才算通 任务 dispatch 了但 Redis 或数据库里完全没数据 不是驱动或连接问题,是任务类本身没达标——Laravel 对“可入队任务”有硬性要求。 任务类必须
implements ShouldQueue
,
php artisan make:job
默认带,但手写类或从旧项目拷贝容易漏掉 构造函数里不能传入无法序列化的对象,比如
Request
实例、
Illuminate\Http\UploadedFile
、DB 连接或闭包 别在
__construct
里做耗时操作(如
Mail::raw()
、
Storage::put()
),这些必须挪到
handle()
方法里 确保调用的是
SendEmail::dispatch()
,不是
dispatch(new SendEmail())
的老写法(虽兼容但易出错) 队列不是魔法开关,它是链式依赖:驱动要通、配置要清、任务要合规、worker 要常驻——少一环,任务就卡在半路,既不失败也不执行。

相关文章