crontab 里 php 8.3 命令不执行 绝对路径和环境变量怎么写

现象

在 Crontab 里加了 */5 * * * * php /var/www/app/artisan schedule:run,等二十分钟也没有任何任务执行。手动在终端里跑同一条命令一切正常,/var/log/cron 里能看到任务被触发,但业务日志是空的。

原因

cron 执行时的环境和登录 shell 完全不同,PATH 通常只有 /usr/bin:/bin。php 如果装在 /usr/local/bin 或只存在 php8.3 命令,就会报 command not found,而错误被丢弃后看起来像没执行。工作目录默认是用户主目录,artisan 找不到 bootstrap 和 .env;运行用户不同也会导致权限和配置读取失败。

解决步骤

第一步,确认命令的绝对路径。在终端执行 which php 和 php -v,记下实际路径和版本,再确认 cron 用户是否有执行权限。

which php
php -v
sudo -u www-data /usr/bin/php8.3 -v

第二步,补全 PATH 和工作目录。在 crontab 顶部声明 SHELL 和 PATH,任务里先 cd 到项目根目录,再用绝对路径调用 php,最后把输出重定向到日志,避免错误被吞掉。

SHELL=/bin/bash
PATH=/usr/local/bin:/usr/bin:/bin
*/5 * * * * cd /var/www/app && php artisan schedule:run

第三步,检查服务和权限。确认 cron 或 crond 服务在运行,SELinux 没有拦截,storage 和日志目录对运行用户可写;Laravel 还需要 php artisan schedule:list 能正常列出任务。

验证

把任务改成每分钟执行一次并重定向日志,日志里出现 schedule:run 的输出,数据库或文件有对应变更,说明 cron 环境已经跑通。

小结

cron 不执行多数是环境和路径问题。写绝对路径、固定工作目录、保留输出日志,三步就能定位绝大多数情况。

您可以还会对下面的文章感兴趣: