Laravel生产共享主机无法运行queue:work且禁用Supervisor的解决方案咨询

我之前在限制极严的共享主机上部署Laravel项目时，也碰到过没法用Supervisor跑队列、没法装额外模块的情况，试了几个实用的方案，亲测有效：

1. 用Cron定时执行单次队列任务 #

这是最稳妥的方案，几乎所有共享主机都支持Cron任务。核心思路是让系统每隔一段时间（比如1分钟）执行一次单次队列任务处理，不用常驻进程，完美避开共享主机的进程限制。

• 设置步骤：
  1. 登录你的共享主机控制面板，找到Cron任务管理界面
  2. 添加一条定时任务，命令如下（记得替换项目路径）：

     * * * * * php /home/your-user/public_html/artisan queue:work --once --queue=default --sleep=3 --tries=3
     

  3. 关键参数解释：
     • --once：只处理一个队列任务就退出，刚好适配Cron的周期性调用
     • --queue=default：指定要处理的队列名称，多队列场景可以调整
     • --sleep=3：如果当前没有任务，等待3秒再退出（减少空跑的资源消耗）
     • --tries=3：单个任务失败后的最大重试次数
• 注意：有些主机的PHP路径可能不是默认的php，需要用完整路径比如/usr/local/bin/php8.1，可以通过which php命令查看正确路径

2. 用受保护的Web路由触发队列处理 #

如果你的主机连Cron都受限（这种情况很少见），可以做一个隐藏的内部路由，通过定时HTTP请求来触发队列任务。

• 操作步骤：
  1. 在routes/web.php中添加带密钥验证的路由：

     Route::get('/internal-run-queue', function () {
         // 严格的密钥验证，防止恶意访问
         if (request()->query('secret') !== env('QUEUE_TRIGGER_SECRET')) {
             abort(403, 'Unauthorized');
         }
         // 执行单次队列任务
         \Illuminate\Support\Facades\Artisan::call('queue:work --once');
         return response('Queue task processed', 200);
     })->middleware('web');
     

  2. 在.env文件中设置一个随机的强密钥：

     QUEUE_TRIGGER_SECRET=your_ultra_long_random_secret_string_here
     

  3. 找一个定时HTTP请求服务，让它每隔1分钟访问这个路由：https://your-domain.com/internal-run-queue?secret=your_ultra_long_random_secret_string_here
• 重要提醒：一定要加密钥验证，绝对不能暴露无保护的路由，否则会有严重的安全风险

3. 切换到数据库队列驱动（前置准备） #

如果之前用的是Redis、Beanstalkd这类需要额外扩展的队列驱动，先切换到数据库驱动——不用安装任何额外模块，共享主机几乎都支持MySQL/PostgreSQL。

• 配置步骤：
  1. 在.env中修改队列连接：

     QUEUE_CONNECTION=database
     

  2. 生成队列任务表并执行迁移：

     php artisan queue:table
     php artisan migrate
     

  3. 完成后配合上面的Cron或Web触发方案即可正常处理队列

额外小技巧 #

• 如果你的任务执行时间较长，可以在queue:work命令中添加--timeout=60参数，限制任务最长执行时间（单位：秒），避免被共享主机的进程超时机制杀掉
• 如果队列任务量不大，可以适当调整Cron的执行间隔，比如每2分钟一次，减少资源消耗

内容的提问来源于stack exchange，提问作者Elbo Shindi Pangestu