Crontab未执行Laravel定时任务问题排查求助

这种情况我之前碰到过好几次，核心问题基本都出在Cron的运行环境和终端环境不一致上，下面是几个最常见的排查点和解决办法：

1. 替换为绝对路径，避免路径解析问题 #

Cron的执行环境里，~的解析或者php命令的路径可能和你终端里的不一样：

• 首先在终端里执行which php，拿到PHP的绝对路径（比如/usr/local/bin/php）
• 把crontab里的命令换成绝对路径写法，比如：

  * * * * * /usr/local/bin/php /root/htdocs/artisan schedule:run >> /var/log/laravel-schedule.log 2>&1
  

  这里把~/htdocs换成了/root/htdocs（root用户的家目录绝对路径），同时用了PHP的绝对路径，避免Cron找不到PHP或者artisan文件。

2. 补充Cron缺失的环境变量 #

终端里有很多环境变量（比如APP_ENV、APP_KEY，甚至PHP的环境变量），但Cron的默认环境变量非常少，Laravel调度依赖这些变量才能正常运行：

• 可以在Cron命令前加载root用户的bash环境配置，比如：

  * * * * * . /root/.bashrc && /usr/local/bin/php /root/htdocs/artisan schedule:run >> /var/log/laravel-schedule.log 2>&1
  

  这样Cron就会继承终端里的环境变量了。
• 或者直接在Cron里指定Laravel的环境变量，比如：

  * * * * * APP_ENV=production APP_KEY=your-key-here /usr/local/bin/php /root/htdocs/artisan schedule:run >> /var/log/laravel-schedule.log 2>&1
  

3. 不要丢弃日志，查看错误信息 #

你之前把输出扔到/dev/null，等于把所有错误信息都屏蔽了，这是排查问题的最大障碍。改成输出到一个日志文件后，你可以直接查看/var/log/laravel-schedule.log，里面会明确告诉你哪里出了问题——比如找不到PHP扩展、环境变量缺失、文件权限不足等等。

4. 检查文件权限（可能性较低，但值得确认） #

虽然你用root用户执行，但如果htdocs目录下的某些文件（比如缓存文件、日志文件）权限不是root的，可能会导致Laravel执行失败。可以执行一下：

chown -R root:root /root/htdocs
chmod -R 755 /root/htdocs/storage /root/htdocs/bootstrap/cache

确保Laravel的存储目录有正确的读写权限。

先试试把日志输出打开，看具体错误信息，这通常能直接定位问题。我之前遇到过就是因为Cron里的PHP路径和终端不一样，导致Laravel的依赖加载失败，改了绝对路径就好了。

内容的提问来源于stack exchange，提问作者nomaki