Laravel队列无日志输出求助：queue:work/listen无内容显示

1. 确认任务是否成功入队 #

• 直接查看数据库的jobs表，检查是否有新增的任务记录。如果没有，说明任务未成功分发：
  • 确保控制器中调用的是队列分发方法，比如dispatch(new HandleBattleProgress())，而非直接调用任务类的handle方法
  • 验证任务类是否正确继承Illuminate\Contracts\Queue\ShouldQueue接口，未继承的任务会同步执行，不会进入队列
  • 在任务分发代码处添加日志或try-catch块，排查是否有隐藏异常导致分发失败

2. 检查队列连接配置 #

• 确认.env文件中QUEUE_CONNECTION=database配置生效，可通过php artisan config:cache清除配置缓存后重启队列进程
• 核对config/queue.php中database连接的配置：
  • 确保table字段指向正确的任务表（默认是jobs）
  • 确认connection字段与应用数据库配置一致，避免队列连接了错误的数据库

3. 排查任务类的handle方法 #

• 检查HandleBattleProgress任务类的handle方法：
  • 确保方法为public权限，无拼写错误（比如误写为handl）
  • 验证日志代码是否正确，比如是否引入Illuminate\Support\Facades\Log，日志语句是否为Log::info('任务执行日志')这类有效写法
  • 在方法最开头添加日志测试，排查是否因方法内提前return或未捕获异常导致日志无法输出

4. 验证队列进程的运行配置 #

• 使用queue:work时，进程会缓存配置，修改.env或队列配置后必须重启进程
• 确认队列进程监听的队列与任务分发的队列一致，可尝试执行php artisan queue:work --queue=default明确指定监听默认队列
• 检查队列进程的运行用户权限，确保其能正常读写数据库和日志文件

5. 检查任务表状态 #

• 查看jobs表的reserved_at字段，若有值说明任务被进程锁定，可手动将该字段设为null，或执行php artisan queue:clear清空队列后重新分发任务
• 查看failed_jobs表，若存在失败记录，可通过exception字段获取具体错误信息

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