Hostinger 上 Laravel database queue 无法通过 Cron 自动处理
结论
建议先确认 Cron 有没有执行,再判断 Laravel 队列是否有问题。手动运行 /usr/bin/php artisan queue:work --stop-when-empty 可以正常消费 jobs 表并发送邮件,这说明 QUEUE_CONNECTION=database、监听器和队列消费逻辑基本正常。连最简单的 echo 测试 Cron 都没有写入 cron-test.log,更可能的情况是 Hostinger Cron 没有真正执行,或者执行命令的环境、路径、权限、转义方式不符合 hPanel 的要求。
先判断 Cron 是否执行
测试 Cron 可以改成脚本方式,避免把复杂重定向直接写进 Cron 命令:
#!/bin/bash
echo "CRON TEST $(date)" >> /home/u581725146/domains/nexcrm.in/public_html/cron-test.log
保存为:
/home/u581725146/domains/nexcrm.in/public_html/cron-test.sh
赋予执行权限:
chmod +x /home/u581725146/domains/nexcrm.in/public_html/cron-test.sh
Hostinger Cron 命令写成:
/bin/bash /home/u581725146/domains/nexcrm.in/public_html/cron-test.sh
等待 2 到 3 分钟,看看 cron-test.log 里有没有新行。如果还是没有,先检查这几项:Cron Job 是否已经启用并保存;计划表达式是否确实是 * * * * *;命令字段有没有被 hPanel 截断或错误转义;Cron 是否以正确的系统用户运行;日志目录和文件对 Cron 运行用户是否可写;Hostinger 控制面板有没有显示 Cron 执行记录或失败通知。走到这一步,问题通常出在 Cron 执行层,Laravel 队列层可以先放一放。
Laravel queue worker 的 Cron 写法
确认 Cron 能执行之后,再用脚本跑队列,避免 cd、&& 和重定向在 Cron 命令字段里被错误处理:
#!/bin/bash
cd /home/u581725146/domains/nexcrm.in/public_html || exit 1
/usr/bin/php artisan queue:work --stop-when-empty --sleep=3 --tries=3 --timeout=90 --max-time=50 >> /home/u581725146/domains/nexcrm.in/public_html/cron-job.log 2>&1
保存为 run-queue.sh,然后加执行权限:
chmod +x /home/u581725146/domains/nexcrm.in/public_html/run-queue.sh
Cron 每分钟执行:
* * * * * /bin/bash /home/u581725146/domains/nexcrm.in/public_html/run-queue.sh
queue:work --stop-when-empty 会在队列空时退出,适合 shared hosting 上每分钟跑一次的 Cron。--max-time=50 是为了避免 worker 一直运行到下一次 Cron 触发;--tries=3 控制失败重试次数;--timeout=90 则要结合业务任务的实际耗时来调整。如果任务可能超过一分钟,建议用 flock 防止重叠,不过要先确认主机支持:
* * * * * /usr/bin/flock -n /tmp/nexcrm-queue.lock /bin/bash /home/u581725146/domains/nexcrm.in/public_html/run-queue.sh
queue:work、schedule:run 怎么选
处理 database 队列任务需要队列 worker,也就是 queue:work 或 queue:listen。schedule:run 只负责运行 Laravel 调度器中定义的任务,它本身不会消费 jobs 表。除非你在 schedule() 里显式安排 queue:work,否则只配置 schedule:run 不会让 SendPaymentConfirmation 自动执行。Hostinger 共享主机上比较常见的做法,是用每分钟一次的 Cron 调用 queue:work --stop-when-empty。如果项目已经在用 Laravel Scheduler,可以再加一条每分钟执行的 schedule:run,但数据库队列仍然需要 worker。
还要检查的细节
需要核对的地方包括:Cron 脚本里的路径和应用路径是否完全一致;/usr/bin/php 是否就是 CLI 使用的 PHP;.env 中的 QUEUE_CONNECTION 是否为 database,如果改过配置,可以执行 php artisan config:clear;storage、bootstrap/cache 和日志文件对 Cron 用户是否可写;有没有多个 worker 同时跑同一批任务;cron-job.log 里有没有 PHP 错误、权限错误或命令未找到的提示。只要 Cron 测试日志仍然不产生,就先把 Hostinger Cron 的执行问题解决,再回到 Laravel 队列配置。
备注:内容仅供参考。
