Laravel队列worker不执行任务，直到同步执行作业才触发

以下是针对性的分步调试方法，逐一排查可能的问题点：

1. 验证Redis队列的任务状态 #

• 打开redis-cli，执行KEYS *test*，确认队列键（默认带laravel:queue:前缀）是否存在，任务是否被正确推入Redis
• 执行LRANGE laravel:queue:test 0 -1，查看队列内的任务内容结构，确认任务格式符合Laravel规范
• 检查Redis持久化配置（RDB/AOF），确认没有写入延迟导致任务暂存内存未刷盘

2. 监控Worker的运行状态与日志 #

• 启动Worker时增加 verbose 参数：php artisan queue:work --queue=test --verbose，实时查看Worker的日志输出，确认是否有任务接收、处理的记录
• 用ps aux | grep queue:work检查Worker进程是否存活，排除进程假死、意外退出的情况
• 临时调整--sleep=1参数，缩小Worker轮询队列的间隔，排除长休眠导致的延迟

3. 核对队列配置一致性 #

• 检查.env中的REDIS_PREFIX，确保Worker和任务派发使用相同的Redis键前缀
• 查看config/queue.php内redis驱动的connection配置，确认指向的Redis连接（如default）与实际使用的一致
• 排查是否存在队列相关的全局钩子（如Queue::before/Queue::after），是否有阻塞性逻辑影响任务触发

4. 测试Redis基础读写能力 #

• 用redis-cli手动推入测试任务：

  LPUSH laravel:queue:test '{"displayName":"App\\Jobs\\TestJob","job":"Illuminate\\Queue\\CallQueuedHandler@call","maxTries":null,"timeout":null,"timeoutAt":null,"data":{"commandName":"App\\Jobs\\TestJob","command":"O:16:\"App\\Jobs\\TestJob\":3:{s:5:\"delay\";N;s:6:\"timeout\";N;s:10:\"connection\";N;}}}'
  

  观察Worker是否立即处理该任务，验证Redis与Worker的通信链路
• 执行PING、SET test_key 1、GET test_key，确认Redis本地连接无响应延迟

5. 排查Mac系统层面限制 #

• 检查Mac防火墙设置，确认未阻止PHP进程访问Redis端口（默认6379）
• 查看系统日志：tail -f /var/log/system.log，排查PHP或Redis相关的系统级报错
• 清空PHP opcache缓存：php -r 'opcache_reset();'，排除缓存导致的代码逻辑异常

6. 隔离业务代码影响 #

• 创建极简测试任务（仅写入日志），测试是否能正常触发，排除TestJob自身的阻塞逻辑
• 在tinker中执行TestJob::dispatch()->onQueue('test')后，立即查看Redis队列状态，确认任务是否被及时推入，而非等待dispatchSync时才批量处理

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