Laravel 5.7定时任务Cron自动执行失效排查求助

首先，既然手动运行php artisan schedule:run正常，但Cron自动执行失效，说明问题大概率出在Cron的执行环境、权限或上下文差异上，而不是Laravel调度器本身。下面是需要重点检查的几个方向，以及更完善的监控方法：

一、需要检查的关键项 #

1. Cron的执行环境与路径问题 #

Cron的默认执行环境和你登录终端后的环境完全不同：

• PHP路径不一致：手动运行时用的php可能是你用户PATH里的版本，但Cron的PATH可能只包含系统基础路径。先在终端执行which php拿到完整路径（比如/usr/bin/php），然后把Cron条目里的php替换成这个完整路径。
• 工作目录不对：Cron默认的工作目录不是你的项目根目录，导致artisan文件找不到。修改Cron条目，先切换到项目目录再执行：

  * * * * * cd /var/www/my-project && /usr/bin/php artisan schedule:run >> /dev/null 2>&1
  

• 环境变量缺失：Laravel依赖.env文件里的配置，但Cron可能无法加载用户的环境变量（比如APP_ENV、数据库连接信息）。可以在Cron命令前先加载环境配置，比如：

  * * * * * source ~/.bash_profile && cd /var/www/my-project && /usr/bin/php artisan schedule:run >> /dev/null 2>&1
  

2. 文件与目录权限问题 #

服务器重启后，可能权限上下文发生了变化：

• 检查storage/logs/schedule/目录是否存在，以及Cron运行用户（比如root或www-data）是否有读写权限：

  ls -l /var/www/my-project/storage/logs/schedule/
  # 如果目录不存在则创建
  mkdir -p /var/www/my-project/storage/logs/schedule/
  # 调整权限，比如给www-data用户
  chown -R www-data:www-data /var/www/my-project/storage/
  

• 确认artisan文件的执行权限（虽然PHP脚本不需要执行权限，但确保文件可读）：

  chmod 644 /var/www/my-project/artisan
  

3. SELinux限制（CentOS特有） #

CentOS默认启用SELinux，重启后可能重置了文件上下文，阻止Cron访问项目文件：

• 临时关闭SELinux测试：

  setenforce 0
  

  如果任务恢复正常，说明是SELinux的问题。需要为项目目录设置正确的SELinux上下文：

  chcon -R -t httpd_sys_rw_content_t /var/www/my-project/storage/
  

• 查看SELinux审计日志确认是否有被阻止的操作：

  grep "denied" /var/log/audit/audit.log | grep my-project
  

4. Laravel内部日志排查 #

查看Laravel的核心日志storage/logs/laravel.log，搜索import:producers相关的错误信息，比如数据库连接失败、依赖缺失、任务执行时的异常，这些信息能直接定位任务不执行的原因。

5. Cron的执行用户上下文 #

手动运行任务时用的是你当前登录的用户（比如admin），但Cron可能用的是root用户，两者的环境、权限完全不同：

• 编辑对应用户的Cron表，比如用www-data用户执行任务：

  sudo crontab -u www-data -e
  

  然后添加正确的Cron条目。

二、更好的Cron任务监控方案 #

1. 不要丢弃Cron执行输出 #

把Cron的输出从/dev/null改为保存到日志文件，这样能看到Cron执行时的所有错误信息：

* * * * * cd /var/www/my-project && /usr/bin/php artisan schedule:run >> /var/www/my-project/storage/logs/cron_schedule.log 2>&1

定期查看这个日志，能快速发现比如“找不到artisan文件”“PHP版本不兼容”等基础问题。

2. 利用Laravel内置的任务监控 #

Laravel 5.7支持直接在调度任务中配置告警和日志：

• 发送任务输出到邮箱：

  $schedule->command('import:producers --create --update --afterOrEqual="-5 minutes"')
           ->everyFiveMinutes()
           ->appendOutputTo(storage_path('logs/schedule/producers_import.log'))
           ->emailOutputTo('your-alert@example.com');
  

• 任务失败时触发自定义告警：

  $schedule->command('import:producers --create --update --afterOrEqual="-5 minutes"')
           ->everyFiveMinutes()
           ->appendOutputTo(storage_path('logs/schedule/producers_import.log'))
           ->onFailure(function () {
               // 这里可以写发送邮件、短信或者调用告警API的逻辑
               Mail::raw('生产者导入任务执行失败！', function ($message) {
                   $message->to('your-alert@example.com')->subject('Laravel定时任务告警');
               });
           });
  

3. 心跳文件监控 #

创建一个心跳文件，让任务每次成功执行时更新它的修改时间，然后用脚本监控这个文件的 freshness：

1. 修改Laravel任务，执行成功后touch心跳文件：

   // 在import:producers命令的handle方法末尾添加
   touch(storage_path('logs/schedule/producers_import_heartbeat'));
   

2. 写一个监控脚本monitor_producers_import.sh：

   #!/bin/bash
   HEARTBEAT_FILE="/var/www/my-project/storage/logs/schedule/producers_import_heartbeat"
   MAX_ALLOWED_AGE=600 # 10分钟，单位秒
   
   if [ ! -f "$HEARTBEAT_FILE" ] || [ $(($(date +%s) - $(stat -c %Y "$HEARTBEAT_FILE"))) -gt $MAX_ALLOWED_AGE ]; then
       echo "生产者导入任务已超过10分钟未执行！" | mail -s "Cron任务告警" your-alert@example.com
   fi
   

3. 把脚本加到Cron里，每分钟执行：

   * * * * * /bin/bash /var/www/my-project/monitor_producers_import.sh >> /dev/null 2>&1
   

4. 系统级日志监控 #

定期查看系统Cron日志/var/log/cron，确认调度器确实每分钟被调用；同时查看系统日志/var/log/messages或用journalctl -u crond.service检查crond服务的运行状态，有没有异常重启或报错。

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