Laravel队列驱动怎么选？配置方法详解

Laravel队列配置看似简单，实则暗藏多重陷阱：改了QUEUE_CONNECTION却仍同步执行？根源在于配置缓存未刷新，开发需清缓存、生产需重缓存，并用tinker验证；database驱动报表不存在？其实是迁移缺失，三张核心表一个都不能少；redis连接失败却静默idle？多半是Docker网络配置错误或REDIS_URL格式不合规；任务dispatch后毫无踪影？可能任务类未实现ShouldQueue、构造函数塞入了不可序列化对象，或调用方式不规范——队列不是开箱即用的魔法，而是驱动、配置、任务、Worker四者严丝合缝的协作链，任一环节断裂，任务就会无声卡死。

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” 很可能就是连接被拒绝后静默退出的表现。

• 检查 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 要常驻——少一环，任务就卡在半路，既不失败也不执行。

今天关于《Laravel队列驱动怎么选？配置方法详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！