TP5.1 定时任务不执行？检查 Crontab 环境变量与日志输出路径

TP5.1定时任务crontab不执行的根本原因是环境变量重置导致command not found，需在crontab顶部声明SHELL、PATH、HOME，或用cd+绝对路径调用php，同时确保日志目录权限正确且cron服务运行中。

TP5.1的定时任务，在本地手动运行一切正常，但一旦交给crontab，就完全没反应了，连日志都不生成。问题其实不是代码的锅，而是crontab的执行环境与ThinkPHP的运行环境存在根本性的错位——PATH、SHELL、HOME全被重置，脚本里调用的php、mysql、redis-cli等命令，自然就报了command not found。

确认cron服务是否真正在跑

先确认你的cron服务有没有真正在跑。执行systemctl status cron或service crond status，看到active (running)才算启动。如果显示inactive (dead)，立刻执行sudo systemctl start cron。

这里有个容易踩的坑：Ubuntu/Debian默认用cron，CentOS/RHEL用crond，名字不同但功能一致，别输错服务名。

看日志——先锁定任务有没有被触发

然后是看日志，先锁定任务有没有被触发。打开终端，执行：
sudo tail -f /var/log/cron

等待下一分钟（或者手动修改crontab时间为* * * * *），观察是否有类似这样的记录：
(www) CMD (php /var/www/html/artisan schedule:run >> /dev/null 2>&1)

如果没有这一行，说明crontab根本没读到你的任务——检查一下是不是用crontab -e编辑的是当前用户，而不是root。这里要特别提醒：千万不要用sudo crontab -e编辑root的任务，却用普通用户身份写脚本路径。

抓输出——让错误浮出水面

接下来是抓输出，让错误浮出水面。把原来crontab里的这行：

* * * * * php /var/www/html/artisan schedule:run

改成：

* * * * * php /var/www/html/artisan schedule:run >> /tmp/tp51_cron.log 2>&1

等一分钟，执行cat /tmp/tp51_cron.log。如果文件为空，说明任务根本没执行；如果出现command not found或Permission denied，就进入下一步。

破环境变量——90%的TP5.1定时失败根源

然后就是破环境变量，这是90%的TP5.1定时任务失败的根源。

方法一：在crontab文件顶部强制声明环境。执行crontab -e，在第一行插入：

SHELL=/bin/bash
PATH=/usr/local/bin:/usr/bin:/bin:/usr/local/php/bin
HOME=/var/www/html

注意：PATH必须包含你系统中php的真实路径，用which php查准，不要照抄示例里的/usr/local/php/bin，它可能根本不存在。

方法二：在artisan调用前加载用户环境。把crontab行改成：

* * * * * cd /var/www/html && /bin/bash -c 'source ~/.bashrc && php artisan schedule:run' >> /tmp/tp51_cron.log 2>&1

这个写法会启动一个完整bash，并加载.bashrc，适合依赖大量自定义PATH或alias的场景。

方法三：在TP5.1的Command类里硬编码路径。打开你的自定义命令类，比如app/command/CheckOrder.php，在handle()方法开头加：

putenv('PATH=/usr/local/bin:/usr/bin:/bin');
putenv('PHP_BINARY=/usr/bin/php');

这样无论cron用什么shell，PHP进程内部都能拿到正确路径。

验路径——TP5.1的storage/logs写不进？

最后是验路径，检查TP5.1的storage/logs写不进去。第一步：确认/var/www/html/storage/logs目录归属是www-data（Ubuntu）或apache（CentOS）。第二步：执行ls -ld /var/www/html/storage/logs，看到权限是drwxrwxr-x才安全。第三步：如果日志仍为空，手动执行一次：
sudo -u www-data php /var/www/html/artisan schedule:run

这一步模拟cron以web用户身份运行，能暴露真实权限问题。如果报Permission denied，就说明目录所有者或SELinux限制了写入。