Ubuntu服务器部署的Laravel Cron Job执行queue:restart后运行异常求助

queue:restart 命令可能引发的异常场景 #

• 队列 worker 进程无守护自动退出：queue:restart 的本质是向所有运行中的队列 worker 进程发送终止信号，要求进程处理完当前任务后退出。如果你没有配置队列进程守护服务（比如 Supervisor），进程终止后不会自动重启，所有异步任务只会被调度器投递到队列中，但不会被消费执行——你手动执行php artisan schedule:run看到的输出仅代表调度器触发了任务投递动作，不代表任务已经被实际执行。
• 缓存驱动异常导致重启锁冲突：命令执行时会在 Laravel 缓存中写入重启时间戳作为重启标记，如果你的缓存驱动存在异常（比如 Redis 连接断开、文件缓存目录权限不足），会导致 worker 进程持续误判需要重启，始终无法进入正常消费状态。
• 跨用户执行权限冲突：如果用 root 权限执行queue:restart，但原本的 worker 进程是站点运行用户（比如 www-data）启动的，会出现权限不足无法终止旧进程，同时后续新启动的 worker 权限和项目存储目录权限不匹配，任务执行时写日志、操作文件失败但不会把报错输出到控制台。

定时任务恢复步骤 #

• 检查队列 worker 存活状态
  执行ps aux | grep queue 查看是否有运行中的队列进程，如果没有有效输出说明 worker 已经全部终止，需要重启。
• 手动测试任务执行逻辑
  切换到项目部署用户（通常为 www-data），执行php artisan queue:work --once 手动消费一个队列任务，校验 HeartbeatJob 逻辑是否正常、日志是否成功写入，排除任务本身的代码错误。
• 配置进程守护保证 worker 持久运行
  推荐使用 Supervisor 管理队列进程，配置参考如下：

  [program:laravel-worker]
  process_name=%(program_name)s_%(process_num)02d
  command=php /你的项目绝对路径/artisan queue:work --sleep=3 --tries=3
  autostart=true
  autorestart=true
  user=www-data
  numprocs=2
  redirect_stderr=true
  stdout_logfile=/你的项目绝对路径/storage/logs/worker.log
  

  配置完成后执行supervisorctl reread && supervisorctl update && supervisorctl start laravel-worker:* 启动守护进程。
• 校验调度器 Cron 配置
  执行crontab -u www-data -l 确认站点用户的 Cron 中已经配置了 Laravel 调度规则，正确配置参考如下：

  * * * * * cd /你的项目绝对路径 && php artisan schedule:run >> /dev/null 2>&1
  

• 清理残留异常缓存
  执行php artisan cache:clear && php artisan config:clear 清除残留的重启标记缓存，避免 worker 误判重启状态。

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