如何配置Laravel Queue Worker实现永久运行？

问题根源分析 #

你当前用Laravel调度每分钟启动queue:work --stop-when-empty的方式存在逻辑矛盾：这个命令本身是处理完队列所有任务就自动退出的一次性命令，加上每分钟调度+withoutOverlapping，不仅会频繁启停worker，更关键的是如果单个任务执行时间超过你设置的60秒，依然会触发超时错误——因为--timeout=60是限制单个任务的最长执行时间，不是worker的运行时长。

具体解决步骤 #

1. 针对单个任务调整超时时间

如果你的任务确实需要超过60秒才能完成，直接修改超时参数即可：

• 全局命令层面调整（适合所有任务）：

  php artisan queue:work --timeout=180 --tries=3
  

  这里把超时设为180秒（根据实际任务耗时调整），同时设置重试次数避免任务丢失。

• 单个任务单独配置（更灵活）：
  在你的任务类里直接定义超时时间，优先级高于命令行参数：

  class ProcessLargeFile implements ShouldQueue
  {
      // 单个任务超时时间，单位秒
      public $timeout = 180;
  
      // 任务执行逻辑
      public function handle()
      {
          // 你的耗时操作代码
      }
  }
  

2. 放弃调度启动，改用进程管理器守护worker

生产环境下，用Laravel调度启动worker是不合理的——正确的做法是让worker长期运行，用进程管理器（如Supervisor、Systemd）保证worker意外退出后自动重启。

以Supervisor为例，创建配置文件/etc/supervisor/conf.d/laravel-worker.conf：

[program:laravel-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /path/to/your/project/artisan queue:work redis --timeout=180 --sleep=3 --tries=3
autostart=true
autorestart=true
user=www-data
numprocs=4
redirect_stderr=true
stdout_logfile=/path/to/your/project/storage/logs/worker.log

然后重启Supervisor：

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start laravel-worker:*

3. 排查额外导致超时的因素

• 检查服务器资源：CPU、内存不足会拖慢任务执行速度，间接导致超时，可通过top或服务器监控工具排查。
• 拆分大任务：如果任务包含大量耗时操作（如批量数据处理、外部API调用），拆分成多个小任务分步执行，避免单个任务超时。
• 查看失败任务日志：通过php artisan queue:failed查看失败任务详情，确认是任务执行超时还是其他报错导致的超时触发。

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