宝塔 crontab 任务不触发 php 命令返回 127 怎么修

现象

在宝塔的计划任务里加了一个 PHP 脚本,手动执行 php Cron.php 一切正常,数据能跑出来,设成每 5 分钟执行一次却从来不执行,任务日志目录是空的,面板上的上次执行时间一直停在添加那一刻。

原因

cron 运行时的环境变量和登录 shell 完全不一样,PATH 里没有 php,脚本第一行就返回 127 command not found,而错误输出被丢弃,所以看起来什么都没发生;脚本里用了相对路径,cron 的工作目录是用户主目录而不是项目目录;crond 服务没启动或被安全策略禁用;任务写进 root 的 crontab,脚本要写的缓存文件属主却是 www,执行了也写不进去。

解决步骤

第一步,命令里全部换成绝对路径。PHP 二进制用完整路径,脚本文件也用完整路径,避免依赖 PATH 与当前目录,这是 127 最直接的解法。

which php
crontab -l
*/5 * * * * /www/server/php/80/bin/php \
  /www/wwwroot/blog/cron.php >> /tmp/cron.log 2>&1

第二步,在 crontab 顶部补环境变量。加上 SHELL 与 PATH 两行,让任务拥有和登录时接近的环境;脚本内部把 include、日志路径都改成绝对路径,并显式切换工作目录。

第三步,确认服务与权限。检查 crond 是否在运行,查看 /var/log/cron 里有没有这条任务的执行记录,再确认脚本要写的目录属主与执行用户一致。

验证

等一个周期,/tmp/cron.log 里出现新的时间戳与业务输出,面板的上次执行时间同步更新,数据表里能看到本次写入的记录。

小结

定时任务不跑,九成是环境差异导致命令没找到。绝对路径、显式 PATH、可写目录三件事做到,cron 基本就不会再静默失败。

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