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