Laravel切换Redis队列后任务调度异常：任务未被正常拾取

可能的原因及解决步骤 #

1. 队列连接与队列名称不匹配 #

• 确认.env中QUEUE_CONNECTION=redis，若任务通过$this->onQueue('xxx')指定了自定义队列，worker需对应启动命令：php artisan queue:work redis --queue=xxx（默认worker仅监听default队列）。
• 清除配置缓存：执行php artisan config:clear后重新进入Tinker测试，避免Tinker加载旧配置。

2. Redis连接异常 #

• 测试Redis服务稳定性：在终端执行redis-cli ping，确认返回PONG，排查是否存在连接超时、丢包或认证失败问题。
• 检查config/database.php中Redis配置项，确保host、port、password（若需认证）等参数正确；若使用Redis集群/哨兵，需对应调整配置。
• 查看storage/logs/laravel.log，搜索Redis关键词，排查是否有连接错误日志。

3. Worker配置或运行状态异常 #

• 调整worker的--sleep参数：默认sleep时长为3秒，若worker处于休眠状态，新任务需等待休眠结束才会被拾取。可尝试缩短休眠时间：php artisan queue:work redis --sleep=1。
• 检查worker内存限制：默认--memory=128，若任务占用内存超过限制，worker会自动退出。可适当调高内存阈值，或查看worker终端输出是否有退出提示。
• 生产环境建议用Supervisor等进程管理器守护worker，防止进程意外终止导致任务无人处理。

4. 任务推入队列验证 #

• 确认任务是否成功推入Redis：在Tinker dispatch任务后，通过redis-cli执行LLEN laravel:queue:default（自定义队列替换对应键名），查看队列长度是否增加。若长度未变化，说明任务未成功推入队列，需排查队列驱动逻辑。
• 同步执行任务验证：在Tinker中使用Bus::dispatchSync(new App\Jobs\BotPlay($game))，若任务能正常执行，说明任务本身逻辑无问题，问题出在队列调度环节。

5. 队列堆积或旧任务干扰 #

• 清理Redis队列：执行php artisan queue:clear redis清除所有待处理任务，排除旧的失败任务堆积导致的异常。
• 检查队列失败任务：执行php artisan queue:failed查看是否有大量失败任务，若存在可通过queue:retry重试或queue:flush清除。

内容的提问来源于stack exchange，提问作者Markwow